A camada verificável de autorização pré-negociação para capital autônomo
Já tem um agente de trading? Adicione o Profit Engine Governor. Mantenha a custódia. Mantenha o controle.
O PE Governor avalia cada intenção de ordem enviada segundo as suas regras, coordena a capacidade da carteira entre agentes e devolve uma autorização assinada de curta duração para o valor permitido exato. Seu executor a verifica; o PE Governor nunca assume custódia nem envia a ordem.
Autorize capital novo, limitado ao valor permitido exato.
Verdict 02REDUCE
Reduza uma posição gerenciada existente. Nunca ultrapasse o valor retornado.
Verdict 03REJECT
Uma regra rígida falhou. Não volte a agir sobre este candidato.
Verdict 04HOLD
Bloqueio temporário ou não selecionado neste ciclo. Aguarde e pergunte de novo.
01Uma decisão determinística, renderizada ao vivo
Uma decisão determinística, renderizada ao vivo
Este cartão vem da mesma política pura executada pelo endpoint pago, a partir da requisição de exemplo abaixo. Entrada idêntica sempre gera hash de decisão idêntico.
Seus agentes emitem até 50 candidatos em um barramento comum: trilha, ativo, lado, nocional solicitado, perda máxima e ganho líquido esperado informados pelo chamador, status de evidência e expiração.
Phase 02
2. Governar
O PE Governor aplica uma única política pura: atualidade do estado, reconciliação, kill switch, evidências, orçamentos de perda, reserva, tetos de nocional e concorrência — depois classifica e escolhe no máximo um vencedor.
Phase 03
3. Obedecer
O capital se move nos seus termos. Mesma requisição na entrada, decisão idêntica byte a byte na saída, com hashes SHA-256 da requisição e da decisão canônicas para auditoria.
02Controle fundamental para capital autônomo
Controle fundamental para capital autônomo
Uma camada de autorização determinística que torna as decisões dos agentes limitadas, auditáveis e portáveis por toda a sua pilha de execução.
Recibos de política à prova de adulteração
Cada resposta vincula a requisição canônica e a decisão com hashes SHA-256, versão da política, carimbo de tempo, valor permitido exato e verificações de observado versus limite. As repetições permanecem idênticas byte a byte.
Governança de todo o portfólio
Avalie até 50 candidatos de várias estratégias contra um único snapshot de portfólio recente e reconciliado. Regras de perda, drawdown, reserva, nocional, concorrência e kill switch se aplicam antes de no máximo um vencedor ser selecionado.
Pagamento nativo para máquinas
Pague o preço publicado por decisão, em faixas de risco em USDC na Base pelo fluxo de checkout da Coinbase Business, ou use créditos pré-pagos. A idempotência evita compras lógicas duplicadas.
A aplicação começa no seu adaptador de execução
O PE Governor devolve a autorização; seu adaptador a verifica e a obedece antes de enviar uma ordem. A Coinbase não aplica atualmente as decisões do PE na corretora, e o pagamento nunca muda o veredito.
03Autorizações assinadas que seu executor pode verificar
Autorizações assinadas que seu executor pode verificar
Cada alocação governada carrega uma autorização de curta duração, assinada criptograficamente e vinculada à sua intenção exata e ao último estado de risco enviado da carteira.
Provas de política verificáveis
A assinatura cobre a carga canônica da prova: emissor, id da chave, veredito, valor exato permitido, candidato, estratégia, trilha, escopo completo, hash da solicitação, hash da decisão, hash do estado da carteira, a cotação durável e a expiração. Baixe a chave pública uma vez e verifique offline.
Reservas atômicas entre agentes
Agentes concorrentes no mesmo inquilino e carteira disputam um único livro de risco agregado. Um candidato vencedor só se torna executável se a reserva for concedida; caso contrário, o veredito é rebaixado para HOLD.
Preço por faixas de risco
O preço de uma decisão acompanha o capital em risco — o maior nocional solicitado ou perda máxima da solicitação. A cotação é determinística e vinculada ao hash. O pagamento compra a avaliação, nunca um veredito.
Preço determinístico por decisão
Capital em risco é max(requestedNotionalUsd, maximumLossUsd) entre os candidatos enviados. Uma unidade de crédito equivale a 0,05 USDC.
Preço determinístico por decisão
Capital em risco
Preço (USDC na Base)
Unidades de crédito
até US$ 1.000
0.05 USDC
1
até US$ 10.000
0.10 USDC
2
até US$ 100.000
1.00 USDC
20
até US$ 500.000
5.00 USDC
100
acima de US$ 500.000
10.00 USDC
200
O mesmo preço vale para ALLOCATE, REDUCE, REJECT e HOLD. Não há assinatura.
Verifique antes de executar
Seu adaptador de execução deve verificar o hash da carga, a assinatura, o emissor e o id da chave, a janela de validade, o token de reserva vigente, todos os hashes esperados e se a ordem corresponde exatamente à intenção e ao valor autorizados. Consuma cada autorização uma única vez em um armazenamento durável e recuse qualquer ordem sem autorização vigente.
verify-authorization.ts
import { verifyAuthorizationForOrder } from "./pe-authorization";
// 1. Fetch and cache the published Ed25519 verification key (kid + issuer).
const { issuer, keys } = await (await fetch("/api/pe/v1/keys")).json();
// 2. Gate every order on a live, exactly matching authorization.
const check = await verifyAuthorizationForOrder({
proof: decision.proof, // returned with every 200
publicKeyBase64Url: keys[0].x,
order: {
candidateId, strategyId, assetId, lane, side, reduceOnly,
amountUsd: decision.allocationAmountUsd, // must equal permittedAmountUsd exactly
tenantId, portfolioId, agentId, ownerId, accountScope,
},
expected: {
issuer,
keyId: keys[0].kid,
policyVersion: decision.policyVersion,
requestHash: decision.audit.requestHash,
decisionHash: decision.audit.decisionHash,
portfolioStateHash: decision.proof.payload.portfolioStateHash,
quoteHash: decision.priceQuote.quoteHash,
reservationFencingToken: decision.proof.payload.reservation.fencingToken,
},
// Durable single-use store: ONE atomic operation, never has() then add().
replayStore: {
consumeIfUnused: async (id) => {
const { rowCount } = await db.query(
"INSERT INTO used_authorizations (id) VALUES ($1) ON CONFLICT DO NOTHING",
[id],
);
return rowCount === 1; // false => already consumed
},
},
});
if (!check.valid) throw new Error(check.reason); // never place the order
placeOrder(decision.allocationAmountUsd);
Chaves de verificação04Reserve a capacidade da carteira por toda a janela de execução
Reserve a capacidade da carteira por toda a janela de execução
Opcional
Verificar uma autorização assinada offline continua sendo suficiente por si só. Se quiser mais, reivindique-a: o PE Governor passa a reter a parcela de capacidade agregada daquela autorização até seu adaptador informar o desfecho, de modo que um segundo agente não gaste a mesma folga duas vezes.
AUTHORIZED
Emitida junto com a decisão e já retendo capacidade durante sua curta janela de validade.
CLAIMED
Seu adaptador vinculou uma chave de reivindicação secreta e agora responde pelo desfecho. Nenhum outro chamador pode alterá-la.
COMMITTED
O adaptador agiu. A capacidade segue retida, porque o capital comprometido está em uso até a conciliação.
RELEASED
O adaptador recuou sem agir. A capacidade volta imediatamente.
EXPIRED
Ninguém retornou a tempo. A capacidade volta sozinha, sem nenhuma chamada de limpeza.
authorization-lifecycle.ts
// Optional. Offline verification of the proof is still sufficient.
const { authorizationId } = decision.lifecycle;
const claimKey = crypto.randomUUID() + crypto.randomUUID(); // >= 32 chars, keep it
const claim = await fetch(`/api/pe/v1/authorizations/${authorizationId}/claim`, {
method: "POST",
headers: { "x-pe-claim-key": claimKey },
});
if (!claim.ok) return; // someone else owns this authorization
try {
await placeOrderWithYourOwnExecutor(intent); // PE Governor never does this
await fetch(`/api/pe/v1/authorizations/${authorizationId}/commit`, {
method: "POST",
headers: { "x-pe-claim-key": claimKey },
});
} catch {
// stand down and give the capacity straight back
await fetch(`/api/pe/v1/authorizations/${authorizationId}/release`, {
method: "POST",
headers: { "x-pe-claim-key": claimKey },
});
}
O estado do ciclo de vida é o registro da sua própria política. Confirmar apenas registra que seu adaptador agiu; o PE Governor continua sem colocar, rotear ou liquidar qualquer ordem.
05Instale a política uma única vez
Instale a política uma única vez
Ligue a chamada antes de qualquer alocação igual ou acima do limite do proprietário. Pare em REJECT ou HOLD e nunca ultrapasse um valor REDUCE.
install-policy.txt
# Install once, obey always.
BEFORE any allocation >= OWNER_THRESHOLD_USD:
decision = POST /api/pe/v1/governor # same-origin; production clients resolve it against https://governor.solarly.ai
if decision.decision in ("REJECT", "HOLD"):
stop() # no order, no retry loop
if decision.decision == "REDUCE":
size = min(intended_size, decision.allocationAmountUsd)
if decision.decision == "ALLOCATE":
size = decision.allocationAmountUsd # never more
execute(size) # execution is 100% yours
Pague por decisão em USDC na Base através de um checkout da Coinbase Business, ou consuma créditos pré-pagos. Não há assinatura. Autorização não é liquidação: só um checkout COMPLETED libera a decisão.
Step 01
POST + chave de idempotência
Uma requisição lógica é reservada atomicamente.
Step 02
402 com URL x402
Exatamente um checkout da Coinbase é criado.
Step 03
202 durante o processamento
Tente de novo com a mesma chave e o mesmo id de checkout.
Step 04
COMPLETED
O polling confirma um checkout COMPLETED. A confirmação por webhook assinado fica disponível quando configurada.
Step 05
Decisão 200
Armazenada uma vez; as repetições são idênticas byte a byte.
A máquina de estados dos códigos HTTP
POST /api/pe/v1/governor (X-Idempotency-Key: uuid-v4)
|
v
402 Payment Required --payment.x402Url--> client pays the checkout
| |
|<---- retry: same key + X-Checkout-Id ------+
v
202 Accepted checkout ACTIVE / PROCESSING --> back off, retry
|
v
checkout COMPLETED (polling; signed webhook when configured)
|
v
200 OK pe-governor-decision.v1, stored once, replays byte-identical
Laço de repetição do cliente
Uma integração mínima. Envie uma chave de idempotência UUID v4, leia a URL x402 e o id do checkout no corpo do 402, pague e depois consulte com a mesma chave e o mesmo id até a decisão ser liberada.
retry-loop.ts
import { randomUUID } from "node:crypto";
const ENDPOINT = "/api/pe/v1/governor"; // same-origin; resolves against https://governor.solarly.ai
const idempotencyKey = randomUUID(); // UUID v4, one per logical decision
// 1. First call: body + idempotency key. No payment yet, so expect 402.
let res = await fetch(ENDPOINT, {
method: "POST",
headers: { "content-type": "application/json", "x-idempotency-key": idempotencyKey },
body: JSON.stringify(governorRequest),
});
if (res.status !== 402) throw new Error(`unexpected status ${res.status}`);
// 2. Read the x402 URL and checkout id straight off the 402 body.
const { payment } = await res.json();
const x402Url: string = payment.x402Url; // where the client pays
const checkoutId: string = payment.checkoutId; // echo this back on every retry
// 3. Pay with your x402 client. The authorization response is NOT settlement:
// only a COMPLETED checkout releases the decision.
await x402Client.pay(x402Url, { amount: payment.amount, asset: payment.currency });
// 4. Poll the same request with the same key + checkout id, backing off.
for (let attempt = 0; attempt < 12; attempt++) {
res = await fetch(ENDPOINT, {
method: "POST",
headers: { "x-idempotency-key": idempotencyKey, "x-checkout-id": checkoutId },
}); // body may be omitted on retries
if (res.status === 200) {
const decision = await res.json(); // pe-governor-decision.v1
console.log(decision.decision, decision.allocationAmountUsd, decision.audit.decisionHash);
break;
}
if (res.status !== 202) throw new Error(await res.text()); // 402/409 are terminal
await new Promise((r) => setTimeout(r, Math.min(500 * 2 ** attempt, 8000)));
}
01. Sem execução de operações e sem envio de ordens
02. Sem custódia, carteiras ou chaves privadas
03. Sem corretagem ou transmissão de dinheiro
04. Nenhum LLM no caminho da decisão
05. Sem previsão própria de retorno e sem alegação de alfa proprietário
06. Ganho esperado e perda máxima são sempre entradas fornecidas pelo chamador
07. Nenhuma imposição nativa na corretora é alegada; seu adaptador aplica cada autorização
08. Uma autorização assinada comprova qual decisão de política foi emitida. Não é certificado de conformidade, decisão de subscrição, atestação on-chain nem aprovação da corretora.