commish

Retén la comisión del router hasta que la llamada sea final. 

Un agente paga 0,05 USDC a una herramienta por HTTP 402. El router que lo envió gana el 10%, reservado on-chain donde la herramienta no puede gastarlo. Tras una ventana de reembolso de 10 minutos, cualquiera puede liberarlo, y solo puede llegar al router. Los primeros usuarios son agentes. Los humanos no están en este ciclo.

Sin custodia y de código abierto. Las reglas de custodia y pago las aplica un programa en Solana mainnet; el relayer verifica cada pago antes de registrarlo.

Sigue la comisión de un router

commish · usdc
Llamadas registradasRetenidaPagadaVendida antes
Tráfico
Ejemplo: 1.000 llamadas pagadas · 50,00 USDC
Comisión del router al 10%
5.00 USDC
Beneficiario
Router

10

Ventana de reembolso

Bóveda sin reservar50.00 / 50.00

Ejemplo, no tráfico real: los agentes pagaron 1.000 llamadas a la herramienta a través de un router. Regístralas para reservar su comisión.

USDCSolana mainnetRefund windowReserved on-chainPermissionless releaseEarly payoutPinocchioOpen sourceNon-custodialUSDCSolana mainnetRefund windowReserved on-chainPermissionless releaseEarly payoutPinocchioOpen sourceNon-custodial

Dirección del programa, en despliegue

Tamaño del programa

9,272 bytes

Instrucciones

6

Pruebas de ataque y flujo

33

Licencia

Apache-2.0

Los agentes pagan por llamada. Los routers cobran por confianza.

Paga al router al instante y pagas los fallos

Una llamada puede fallar, agotar el tiempo o reembolsarse. Una herramienta que paga a su router en cada pago paga comisión por llamadas que luego devuelve.

Retén la comisión y el router confía en una hoja de cálculo

Si la herramienta guarda la comisión hasta estar segura, el router no tiene registro de lo que se le debe ni forma de cobrar si la herramienta deja de pagar.

Velocidad de máquina, papeleo humano

Los agentes hacen miles de pagos de 5 centavos. Facturas, mínimos de pago y liquidaciones mensuales no encajan, y nadie está ahí para aprobar.

Cómo funciona

Pagar, registrar, retener, liberar

01

Pagar

Un agente pide una ruta de pago y recibe 402 Payment Required. Paga 0,05 USDC a la bóveda de la campaña, con un memo que nombra al router que lo envió.

02

Registrar

El relayer lee el pago on-chain y lo registra. El programa calcula el 10% del router según la tarifa de la campaña y lo reserva en su propia cuenta.

03

Retener

Dentro de la ventana de 10 minutos una llamada reembolsada aún puede cancelarse, con un reembolso on-chain como prueba. Al cerrar la ventana, la comisión se debe.

04

Liberar

Después cualquiera puede liberarla. Solo puede llegar a la cuenta USDC del router, y la renta de la cuenta vuelve a quien la pagó.

Garantías

Reglas que la herramienta no puede doblar

El programa comprueba cada una, y las pruebas atacan cada una.

Lo debido queda bloqueado

Los retiros solo tocan la parte de la bóveda que no está reservada para routers.

Un pago, una comisión

La dirección de la comisión sale de un hash de la firma del pago, así que el programa rechaza un segundo registro mientras la comisión está abierta. Después de cerrarse, el relayer revisa el historial on-chain de esa dirección y rechaza el pago.

Solo el attestor registra

Cada campaña nombra una clave attestor, el relayer. El monto sale de la tarifa de la campaña, nunca de quien llama.

Los pagos no se desvían

La liberación paga la cuenta de token del beneficiario actual, en el token de la campaña, y nada más.

Sin cancelar tras la ventana

Pasada la ventana de reembolso, una comisión solo puede pagarse.

Funciona sin este sitio

Liberar no requiere permiso. Si este sitio cayera, los routers podrían cobrar igual.

Cobro anticipado

Vende una comisión pendiente por USDC ahora

Una comisión retenida es dinero debido en una fecha. Para herramientas con ventanas de reembolso más largas, el router puede venderla con un pequeño descuento a un comprador que paga ahora y cobra al liberarse. El comprador asume el riesgo de reembolso.

Se liquida en una transacción: el comprador paga al router y pasa a ser el beneficiario. Nada más cambia.

El router recibe hoy

48.75

El comprador cobra al liberar

50.00

Rendimiento anual del comprador133.7%

Para herramientas

  • Cobra a los agentes por llamada vía HTTP 402, en USDC
  • Paga a los routers por tráfico: el programa retiene la comisión, no tú ni ellos
  • Define la comisión y la ventana una vez por campaña
  • El propio pago financia la bóveda: no hace falta saldo en USDC
  • Retira lo no reservado cuando quieras
Crear una campaña

Para routers

  • Nómbrate en el memo del pago: commish:<tu wallet>
  • Cada comisión ganada, visible on-chain
  • Pagada a tu wallet al cerrar la ventana
  • Cobra aunque la herramienta deje de responder
Ver mis comisiones

Integración

Registrar una llamada pagada

El relayer firma una instrucción por pago verificado. El hash de la orden es SHA-256 de la campaña y la firma del pago, así que el mismo pago siempre apunta a la misma dirección de comisión.

// The relayer, after it has read a successful USDC transfer into the vault.
import { recordSaleIx, COMMISSION_LEN } from "./commish/program";
import { createHash } from "node:crypto";
// The order hash is bound to the payment signature; the relayer also refuses a payment whose closed commission was recorded before.
const hash = createHash("sha256").update("commish:x402:" + campaign + ":" + paymentSig).digest();
const { instruction } = await recordSaleIx({
attestor: relayer.address, // the key named by the campaign
payer: relayer.address, // rent for the commission account
campaign,
vault,
orderHash: hash,
orderAmount: 50_000n, // 0.05 USDC paid by the agent, 6 decimals
creator: router, // from the payment memo commish:<router>
lamports: await rpc.getMinimumBalanceForRentExemption(BigInt(COMMISSION_LEN)).send(),
});
await sendAndConfirm([instruction], [relayer]); // your usual send helper

Preguntas

La bóveda de la campaña: una cuenta de token USDC propiedad de la dirección de la campaña. Solo el programa puede sacar fondos, y solo según las reglas de arriba.

Paga a los routers por tráfico de agentes, con la comisión retenida on-chain.

Llama al endpoint 402 en vivo, o crea una campaña con cualquier wallet de Solana.