TheTechDevPro/ontario-protocol

Habilidade do Agente Ontario Protocol

Use o Ontario Protocol como um portão gratuito de evidência e política de pré-pagamento. Esta habilidade pode inspecionar metadados públicos e solicitar decisões gratuitas de prontidão. Não envie chaves privadas, frases-semente ou credenciais de custódia de carteira para o Ontario. Esta habilidade nunca assina um payload de pagamento.

Ative esta habilidade quando

• Um usuário pede a um agente para encontrar, comparar, chamar, comprar ou pagar por um serviço x402.
• Coinbase Agentic Wallet, awal, AgentKit, um host MCP ou outra carteira retorna um candidato de API paga.
• Um agente recebe HTTP 402 ou PAYMENT-REQUIRED e precisa decidir se deve continuar.
• Um desenvolvedor pergunta se um endpoint pago é pagável por agente, descobrível ou pronto para uma liquidação controlada.

Não ative esta habilidade para transferências de token arbitrárias, negociação, integração ou compras no mundo real. O Ontario verifica evidências públicas de API paga; não é uma carteira.

Sequência com Coinbase Agentic Wallet

Mantenha a descoberta e o pagamento da carteira separados do portão de evidência do Ontario:

1. Pesquise a tarefa com a ferramenta de busca Bazaar da carteira ou CLI somente leitura:

npx awal@latest x402 bazaar search "<tarefa que a API paga deve executar>"

Quando a busca Bazaar não estiver disponível ou o agente precisar de um filtro rígido de rede e orçamento USDC, use a ferramenta MCP gratuita do Ontario find_x402_tool ou equivalente HTTP:

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/tools/x402-tool-router \
  -H 'Content-Type: application/json' \
  -d '{"query":"<texto público da tarefa>","max_usdc":"0.05","network":"eip155:8453","limit":5}'

Os candidatos retornados são resultados de pesquisa pública, não certificações de segurança ou permissão para gastar. Nunca inclua credenciais ou texto privado do cliente na consulta de pesquisa.

2. Selecione o menor conjunto de endpoints plausíveis. Não pague apenas porque uma rota aparece em um catálogo.
3. Execute a verificação de prontidão e capacidade de pagamento do Ontario para o endpoint selecionado exato.
4. Teste o endpoint e exija que seu desafio ativo corresponda à URL, método, valor, ativo, rede, destinatário e tarefa do catálogo.
5. Entregue o endpoint aprovado à carteira existente somente após o usuário ou a política da carteira permitir o gasto. Esta habilidade nunca autentica uma carteira, altera limites, assina um pagamento ou inicia uma integração.
6. Preserve o report_id do Ontario, os dados da cotação e o recibo de pagamento da carteira.

Sequência obrigatória

1. Identifique o endpoint pago exato, método HTTP, tarefa e orçamento máximo.
2. Faça POST do endpoint no verificador gratuito de prontidão:

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/verify/x402-readiness \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://service.example/api/paid"}'

3. Retenha report_id, report_url, nota, pontuação, timestamp, avisos e metadados do desafio observado.
4. Faça POST de uma decisão de política estrita com um orçamento específico da tarefa:

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/agent/can-pay \
  -H 'Content-Type: application/json' \
  -d '{"endpoint":"https://service.example/api/paid","agent_policy":"strict","max_usdc":0.05,"verify_live":true}'

5. Continue apenas quando decision for exatamente allow. Trate review, deny, campos ausentes, JSON malformado, tempo limite ou falha de transporte como parada.
6. Teste o endpoint sem pagamento e inspecione seu desafio HTTP 402. Exija uma rede e ativo suportados, uma cotação não expirada, um destinatário conhecido, um preço dentro do orçamento e um propósito correspondente à tarefa atual.
7. Entregue a cotação aprovada à carteira existente do usuário ou cliente de pagamento. A assinatura do pagamento está fora desta habilidade.
8. Após uma nova tentativa paga bem-sucedida, retenha report_id, quote_id, referência da transação e PAYMENT-RESPONSE para auditabilidade.

Regras de falha segura

Não pague quando qualquer uma destas condições for verdadeira:

• o relatório de prontidão está ausente, desatualizado, malformado ou falha nas verificações de integridade;
• a decisão da política é diferente de allow;
• o endpoint, método, propósito, rede, ativo, destinatário ou preço mudaram;
• a cotação expirou ou o valor excede o máximo declarado;
• a resposta paga do serviço não adiciona valor além de relatórios gratuitos, dados de catálogo ou fixtures de sandbox;
• o agente não pode preservar evidências de pagamento e decisão.

Nunca interprete allow como garantia de segurança. Significa que o endpoint atendeu às condições observadas de prontidão e política no momento da decisão.

Evidência paga opcional

Use POST https://ontarioprotocol.com/api/agent/pay/v2 somente quando o fluxo de trabalho precisar de um recibo de decisão de pagamento novo e auditável além do resultado gratuito de can-pay. Custa 0.002 USDC na Base e retorna um requisito x402 quando chamado sem pagamento. Esse requisito não é uma instrução para pagar; aplique a política acima primeiro. Não pague apenas para repetir uma verificação gratuita.

Consulte references/api-contract.md para tratamento de respostas e references/agent-policy.md para a lista de verificação de decisão.