AiFinPay

Servidor MCP para agentes de IA autônomos: identidade persistente do agente, resolução de Agent Passport, descoberta de rotas, histórico de pagamentos, cotas e faturas de liquidação AIFP-1/AIFP-2 sem assinatura.

GitHub

Documentação

AiFinPay — trilhos financeiros para agentes de IA

A AiFinPay fornece infraestrutura de pagamento e monetização para agentes de IA autônomos.

Lado do agente: identidade, descoberta de carteira, histórico de pagamentos, descoberta de rotas, cotas e preparação de liquidação.
Lado do comerciante: paywalls HTTP 402 e monetização por requisição para tráfego de IA.
Design não custodial: chaves privadas permanecem com o agente/operador. Ferramentas públicas MCP não expõem seeds ou chaves privadas.

Domínio canônico: https://aifinpay.io

Versões atuais dos pacotes

Pacote	Versão atual da fonte	Instalação
`aifinpay-agent` (Python)	`2.1.0`	`pip install aifinpay-agent`
`@aifinpay/agent` (Node / TypeScript)	`2.0.1`	`npm install @aifinpay/agent`
`@aifinpay/mcp`	`2.1.0`	`npx @aifinpay/mcp`
`@aifinpay/mcp-http`	`2.0.2`	Wrapper HTTP Streamable
`@aifinpay/skill`	`2.0.9`	`npm install @aifinpay/skill`
`@aifinpay/gate`	`0.3.2`	`npm install @aifinpay/gate`
`@aifinpay/wallet`	`1.1.0`	`npm install @aifinpay/wallet`
`@aifinpay/deployments`	`1.1.2`	pacote de registro de implantação

As linhas de pacotes são versionadas de forma independente. Os manifests de pacotes neste repositório e os registros npm/PyPI correspondentes são a fonte da verdade.

Instalação

# MCP
npx @aifinpay/mcp

# Node / TypeScript SDK
npm install @aifinpay/agent

# Python SDK
pip install aifinpay-agent

# Merchant paywall
npm install @aifinpay/gate

# Agent skills
npm install @aifinpay/skill

MCP: superfície de produção atual

A fonte atual @aifinpay/mcp expõe as seguintes ferramentas de produção:

Ferramenta	Finalidade
`agent_address`	Ler os endereços públicos atuais de EVM, Solana e Casper.
`agent_reload`	Recarregar arquivos de carteira locais configurados sem iniciar uma nova conversa.
`agent_quota`	Ler a cota do agente.
`agent_history`	Ler o histórico de pagamentos indexado da AiFinPay ou o histórico de recibos retidos.
`agent_passport_resolve`	Resolver uma identidade pública do Agent Passport e vínculos de carteira verificados.
`settlement_routes`	Ler rotas de liquidação AIFP-1 / AIFP-2 verificadas em tempo de execução.
`settlement_invoice`	Construir e validar uma fatura de liquidação EVM sem assinatura.
`settlement_solana`	Construir e validar uma fatura de liquidação Solana sem assinatura.
`settlement_casper`	Construir e validar uma fatura de liquidação Casper sem assinatura.
`deployment_info`	Ler endereços de implantação, IDs de programa e status de liquidação em ecossistemas suportados.

Com AIFINPAY_MODE=dev, uma ferramenta adicional dev_payment_quote está disponível para inspeção de cotações apenas em desenvolvimento.

A superfície pública MCP não assina nem transmite pagamentos. Criar uma fatura ou cotação não é um pagamento concluído.

Ferramentas legadas como payable_fetch, agent_call, agent_quote, pay_with_split, quote_split e agent_claim_self não são registradas pelo servidor MCP de produção atual.

Configuração do cliente MCP

{
  "mcpServers": {
    "aifinpay": {
      "command": "npx",
      "args": ["-y", "@aifinpay/mcp"]
    }
  }
}

Para uma identidade local persistente, inicialize o keystore uma vez:

npx @aifinpay/mcp init

Em seguida, use agent_reload e agent_address para verificar a carteira pública selecionada. Não cole seeds ou chaves privadas em chat, issues, logs ou configuração compartilhada.

Configuração completa do cliente: MCP_CONFIG.md

Status de pagamento do SDK

As superfícies do SDK têm status de execução diferentes. Não as trate como intercambiáveis.

Node / TypeScript

@aifinpay/agent inclui o caminho revisado AIFP-1 fetchPaid. A execução paga é controlada por verificações em tempo de execução, incluindo a implantação/perfil Polygon v1.3 revisado e um preço nativo/USD confiável e recente. Uma cotação, fatura ou hash de execução correspondente por si só não é prova de que uma rota está habilitada para produção.

Consulte node/README.md e node/PAYMENT_RECEIPTS.md.

Python

O pacote Python suporta identidade e funções relacionadas do SDK, mas seu caminho de liquidação pago legado call() está desabilitado e atualmente não expõe o executor Node fetchPaid.

Consulte python/README.md.

Economia

Economia atual do protocolo documentada na linha v2:

AIFP-1: o pagador paga o valor bruto cotado; o comerciante recebe 99%; a AiFinPay recebe 1%; criador/indicação recebe 0%.
AIFP-2 / x402: o provedor recebe 100%; a taxa do protocolo AiFinPay é atualmente 0%.

Exemplos mais antigos de 98,99% / 1% / 0,01% pertencem a um modelo de taxa aposentado e não devem ser usados como economia atual.

Monetização do comerciante

Para um site ou API que queira monetizar tráfego de agentes de IA:

npm install @aifinpay/gate

O pacote do comerciante pode retornar desafios HTTP 402, expor metadados de descoberta e medir acesso pago. Consulte gate/README.md e a habilidade aifinpay-merchant em skill/skills/aifinpay-merchant/SKILL.md.

Status de implantação

Endereços de implantação e IDs de programa são dados de registro; eles não são, por si só, prova de que a liquidação está habilitada. Use deployment_info ou o registro de implantação e verifique settlementEnabled / status antes de apresentar uma rede como ativa.

Solana

O antigo programa Solana 5g9zWHF1Vv6GiGpA2ZbJQbSCDZd5hAk9AyvabRJvKFx2 foi encerrado e não é o programa atual.

O registro atual contém os programas v1.4.1 reimplantados abaixo, ambos atualmente desabilitados para liquidação:

Rede	ID do programa	Status de liquidação	Motivo
Devnet	`8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y`	Desabilitado	A verificação de recibos no backend não está implementada.
Mainnet	`724Ut31i4ecY4dJ25z8HuZetu3A43xtNkPdk4JdbsfdD`	Desabilitado	A verificação de recibos no backend não está implementada e a autoridade de upgrade não é multisig.

Fonte canônica do registro: deployments/registry/splitter/solana/deployments.json

Evidências históricas de mainnet

Estas são apenas transações históricas. Elas não certificam a versão atual, o modelo de taxa ou a prontidão de produção atual.

Provedor	Ativo	Uso histórico	Transação
Exa Search	POL	Chamada SDK via Exa	`0xeb13c5eddf645b3e5b5e5db82d8b19d301a4c0c8593f6e7dce9cd4c3359c8700`
io.net	POL	Inferência Llama-3.3-70B, $0,025	`0x7c6ca0ffcf75b1ca3ade4800fb896c4bb08bc5f1a91916dc2cf4918f16129f0a`

Estrutura do repositório

sdk/
├── node/          @aifinpay/agent
├── python/        aifinpay-agent
├── mcp/           @aifinpay/mcp
├── mcp-http/      Streamable HTTP wrapper
├── skill/         @aifinpay/skill
├── gate/          merchant HTTP 402 paywall
├── wallet/        lightweight agent wallet / keystore
├── deployments/   deployment registry
└── examples/      integrations and reference examples

Regras de segurança

Nunca imprima, registre ou publique uma seed, chave privada, JSON de keystore ou segredo de assinatura.
Endereços públicos e hashes de transação são seguros para exibir.
Não infira prontidão de produção a partir de um endereço de contrato, ID de programa, cotação ou fatura isoladamente.
Retenha a cotação original, a referência da transação e o contexto de idempotência ao se recuperar de um erro de liquidação para evitar tentativas de pagamento duplicadas acidentais.

Licença

MIT — consulte LICENSE.