La capa verificable de autorización previa a la operación para el capital autónomo
¿Ya tienes un agente de trading? Añade Profit Engine Governor. Conserva la custodia. Conserva el control.
PE Governor evalúa cada intención de orden enviada frente a tus reglas, coordina la capacidad de la cartera entre agentes y devuelve una autorización firmada de corta duración por el importe permitido exacto. Tu ejecutor la verifica; PE Governor nunca custodia fondos ni coloca la orden.
Autoriza capital nuevo, limitado al importe permitido exacto.
Verdict 02REDUCE
Reduce una posición gestionada existente. Nunca superes el importe devuelto.
Verdict 03REJECT
Falló una regla estricta. No vuelvas a actuar sobre este candidato.
Verdict 04HOLD
Bloqueo temporal o no seleccionado en este ciclo. Detente y vuelve a preguntar.
01Una decisión determinista, renderizada en vivo
Una decisión determinista, renderizada en vivo
Esta tarjeta la produce la misma política pura que ejecuta el endpoint de pago, a partir de la solicitud de ejemplo siguiente. Una entrada idéntica siempre produce un hash de decisión idéntico.
Tus agentes emiten hasta 50 candidatos en un bus común: carril, activo, lado, nocional solicitado, pérdida máxima y ventaja neta esperada aportadas por el emisor, estado de evidencia y caducidad.
Phase 02
2. Gobernar
PE Governor aplica una única política pura: frescura del estado, conciliación, interruptor de parada, evidencia, presupuestos de pérdida, reserva, topes de nocional y concurrencia; luego clasifica y elige como máximo un ganador.
Phase 03
3. Obedecer
El capital se mueve según tus términos. La misma solicitud entra y sale una decisión idéntica byte a byte, con hashes SHA-256 de la solicitud y la decisión canónicas para auditoría.
02Control fundamental para el capital autónomo
Control fundamental para el capital autónomo
Una capa de autorización determinista que hace que las decisiones de los agentes sean acotadas, auditables y portables en toda tu pila de ejecución.
Recibos de política a prueba de manipulación
Cada respuesta vincula la solicitud canónica y la decisión con hashes SHA-256, la versión de la política, la marca de tiempo, el importe permitido exacto y las comprobaciones de valor observado frente al límite. Las repeticiones son idénticas byte a byte.
Gobernanza de toda la cartera
Evalúa hasta 50 candidatos de varias estrategias contra una única instantánea de cartera reciente y conciliada. Las reglas de pérdida, drawdown, reserva, nocional, concurrencia e interruptor de emergencia se aplican antes de seleccionar como máximo un ganador.
Pago nativo para máquinas
Paga el precio publicado por decisión, escalonado por riesgo en USDC en Base mediante el flujo de checkout de Coinbase Business, o usa créditos prepagados. La idempotencia evita compras lógicas duplicadas.
La aplicación empieza en tu adaptador de ejecución
PE Governor devuelve la autorización; tu adaptador la verifica y la obedece antes de enviar una orden. Coinbase no aplica actualmente las decisiones de PE en el mercado, y el pago nunca cambia el veredicto.
03Autorizaciones firmadas que tu ejecutor puede verificar
Autorizaciones firmadas que tu ejecutor puede verificar
Cada asignación gobernada lleva una autorización de corta duración, firmada criptográficamente y vinculada a su intención exacta y al último estado de riesgo enviado de la cartera.
Pruebas de política verificables
La firma cubre la carga canónica de la prueba: emisor, id de clave, veredicto, importe exacto permitido, candidato, estrategia, carril, ámbito completo, hash de la solicitud, hash de la decisión, hash del estado de la cartera, la cotización duradera y la caducidad. Descarga la clave pública una vez y verifica sin conexión.
Reservas atómicas entre agentes
Los agentes concurrentes del mismo inquilino y cartera compiten por un único libro de riesgo agregado. Un candidato ganador solo es ejecutable si se concede la reserva; de lo contrario, el veredicto pasa a HOLD.
Precio por bandas de riesgo
El precio de una decisión escala con el capital en riesgo: el mayor nocional solicitado o pérdida máxima de la solicitud. La cotización es determinista y está ligada al hash. El pago compra la evaluación, nunca un veredicto.
Precio determinista por decisión
El capital en riesgo es max(requestedNotionalUsd, maximumLossUsd) entre los candidatos enviados. Una unidad de crédito equivale a 0,05 USDC.
Precio determinista por decisión
Capital en riesgo
Precio (USDC en Base)
Unidades de crédito
hasta 1.000 $
0.05 USDC
1
hasta 10.000 $
0.10 USDC
2
hasta 100.000 $
1.00 USDC
20
hasta 500.000 $
5.00 USDC
100
más de 500.000 $
10.00 USDC
200
El mismo precio se aplica a ALLOCATE, REDUCE, REJECT y HOLD. No hay suscripción.
Verifica antes de ejecutar
Tu adaptador de ejecución debe verificar el hash de la carga, la firma, el emisor y el id de clave, la ventana de validez, el token de reserva vigente, todos los hashes esperados y que la orden coincida exactamente con la intención y el importe autorizados. Consume cada autorización una sola vez en un almacén duradero y rechaza cualquier orden sin autorización 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);
Claves de verificación04Retén la capacidad de la cartera durante toda la ventana de ejecución
Retén la capacidad de la cartera durante toda la ventana de ejecución
Opcional
Verificar una autorización firmada sin conexión sigue siendo suficiente por sí solo. Si quieres más, reclámala: PE Governor retiene entonces la parte de capacidad agregada de esa autorización hasta que tu adaptador informe del resultado, de modo que un segundo agente no pueda gastar dos veces el mismo margen.
AUTHORIZED
Emitida con la decisión y reteniendo ya capacidad durante su breve ventana de validez.
CLAIMED
Tu adaptador fijó una clave de reclamación secreta y ahora es responsable del resultado. Ningún otro llamante puede cambiar su estado.
COMMITTED
El adaptador actuó. La capacidad sigue retenida, porque el capital comprometido está en uso hasta que concilies.
RELEASED
El adaptador se retiró sin actuar. La capacidad se devuelve de inmediato.
EXPIRED
Nadie informó a tiempo. La capacidad se devuelve sola, sin necesidad de ninguna llamada de limpieza.
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 },
});
}
El estado del ciclo de vida es el registro de tu propia política. Confirmar deja constancia de que tu adaptador actuó; PE Governor sigue sin colocar, enrutar ni liquidar ninguna orden.
05Instala la política una sola vez
Instala la política una sola vez
Conecta la llamada antes de cualquier asignación igual o superior al umbral del propietario. Detente ante REJECT o HOLD y nunca superes un importe 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
Paga por decisión en USDC sobre Base mediante un checkout de Coinbase Business, o consume créditos prepagados. No hay suscripción. La autorización no es liquidación: solo un checkout COMPLETED libera la decisión.
Step 01
POST + clave de idempotencia
Una solicitud lógica se reserva de forma atómica.
Step 02
402 con URL x402
Se crea exactamente un checkout de Coinbase.
Step 03
202 mientras se procesa
Reintenta con la misma clave y el mismo id de checkout.
Step 04
COMPLETED
El sondeo confirma un checkout COMPLETED. La confirmación por webhook firmado está disponible cuando se configura.
Step 05
Decisión 200
Se almacena una vez; las repeticiones son idénticas byte a byte.
La máquina de estados de 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
Bucle de reintento del cliente
Una integración mínima. Envía una clave de idempotencia UUID v4, lee la URL x402 y el id del checkout en el cuerpo del 402, págalo y luego consulta con la misma clave y el mismo id de checkout hasta que se libere la decisión.
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. Sin ejecución de operaciones ni envío de órdenes
02. Sin custodia, monederos ni claves privadas
03. Sin intermediación ni transmisión de dinero
04. Ningún LLM en la ruta de decisión
05. Sin previsión propia de rentabilidad ni afirmaciones de alfa propietario
06. La ventaja esperada y la pérdida máxima siempre son datos aportados por el emisor
07. No se afirma ninguna aplicación nativa en el mercado; tu adaptador aplica cada autorización
08. Una autorización firmada prueba qué decisión de política se emitió. No es un certificado de cumplimiento, una decisión de suscripción, una atestación on-chain ni una aprobación del mercado.