Pyrimid Protocol
Distribuição de afiliados onchain para agentes de IA na Base — agentes descobrem produtos, ganham comissões em USDC via contratos inteligentes e liquidam instantaneamente.
GitHubExperimente este MCPPatrocinado
Documentação
Pyrimid Protocol
Infraestrutura de comércio para agentes para ferramentas MCP pagas e produtos de IA/API x402 na Base.
Site · Início rápido · Servidor MCP · SDK no npm · Contratos
O que é Pyrimid?
Pyrimid é um protocolo onde vendedores vendem ferramentas MCP pagas / APIs de IA, agentes descobrem e compram via x402, e comissões são liquidadas instantaneamente em USDC via contratos inteligentes na Base.
Agent discovers a product → purchases via x402 → smart contract splits payment:
1% → Protocol treasury
0–50% → Affiliate agent (set by vendor)
Remainder → Vendor
Sem afiliado? O vendedor fica com 99%. Os vendedores só pagam pela distribuição que gera vendas reais. Apenas uma camada — sem MLM, sem pirâmides. Apenas divisão de comissões limpa e transparente onchain.
Por que Pyrimid?
| Problema | Solução da Pyrimid |
|---|---|
| Agentes não conseguem monetizar recomendações | Ganhe comissões recomendando produtos aos usuários |
| Vendedores não conseguem alcançar agentes em escala | Liste uma vez, seja descoberto por todos os agentes da rede |
| Pagamentos de comissões são lentos e opacos | Liquidação instantânea em USDC via contratos inteligentes — totalmente auditável |
| Sem padrão para comércio de agentes | Pagamentos x402 + ferramentas MCP + registro onchain = padrão aberto |
Início Rápido
Instale o SDK
npm install @pyrimid/sdk
Para Agentes — Encontre e Recomende Produtos
import { PyrimidResolver } from '@pyrimid/sdk';
const resolver = new PyrimidResolver({ affiliateId: 'af_your_id' });
// Search the catalog
const product = await resolver.findProduct("trading signals");
// Purchase with x402 payment (auto-splits commissions)
if (product) {
const receipt = await resolver.purchase(product, agentWallet);
console.log(`Earned: $${receipt.affiliate_earned / 1_000_000} USDC`);
}
Para Vendedores — Liste Seu Produto
import { pyrimidMiddleware } from '@pyrimid/sdk';
// 10 lines to activate affiliate distribution
app.use(pyrimidMiddleware({
vendorId: 'vn_your_id',
products: {
'/api/signals/latest': {
productId: 'signals_latest',
price: 250_000, // $0.25 USDC
affiliateBps: 1000, // 10% to affiliates
},
},
}));
Para Frameworks — Incorpore como Camada Padrão
import { createPyrimidMcpServer } from '@pyrimid/sdk';
// Deploy an MCP server — agents connect, browse, buy
const server = createPyrimidMcpServer({
affiliateId: 'af_your_id',
serverName: 'my-recommender',
});
Superfícies de teste ao vivo para agente-comprador
Chame estes sem pagamento para receber HTTP 402 com metadados x402 accepts[]. Tente novamente com X-PAYMENT ou X-PAYMENT-TX após o pagamento.
| Endpoint | Preço | Caso de uso |
|---|---|---|
/api/v1/paid/signals | $0.25 | Snapshot de sinal de derivativos de BTC |
/api/v1/paid/agentzone-search?q=agent-commerce | $0.05 | Busca de agente confiável |
/api/v1/paid/mya-agent-enrichment?agent=demo | $0.10 | Enriquecimento de listagem de agente |
/api/v1/paid/mya-category-scout?category=developer-tools | $0.05 | Exploração de categorias para agentes compradores |
/api/v1/paid/vendor-lead-discovery?segment=mcp | $0.25 | Descoberta de leads de vendedores |
/api/v1/paid/mcp-server-audit?url=https://example.com/mcp | $0.10 | Auditoria de monetização MCP |
/api/v1/paid/x402-integration-plan?service=agent-api | $0.10 | Plano de integração x402 para vendedores |
Três Caminhos de Integração
| Caminho | Quem | Esforço | Alavancagem |
|---|---|---|---|
| Resolvedor Embutido | Frameworks e kits de ferramentas para agentes | 3 linhas | Cada agente na sua stack gera comissões para você |
| Servidor MCP | Provedores de infraestrutura para agentes | 5 linhas | Agentes se conectam ao seu servidor para descobrir produtos |
| Middleware de Vendedor | Construtores de API e produtos | 10 linhas | Ative a distribuição de afiliados no seu produto |
Contratos Inteligentes (Base Mainnet)
Todos os contratos são implantados e verificados na Base. Padrão de proxy atualizável ERC-1967.
| Contrato | Endereço | Propósito |
|---|---|---|
| Registry | 0x34e22fc2...389 | Registro de afiliados e vendedores, vinculação de identidade ERC-8004 |
| Catalog | 0xC935d6B7...908 | Listagens de produtos com preços e taxas de comissão |
| Router | 0xc949AEa3...68B | Mecanismo de divisão de comissões com proteção de slippage maxPrice |
| Treasury | 0x74A512F4...12C | Fundo de operações do protocolo |
Referência da API
A API Pyrimid é gratuita para leitura, com limite de taxa (60 req/min) e retorna JSON.
| Endpoint | Método | Descrição |
|---|---|---|
/api/v1/catalog | GET | Catálogo completo de produtos com busca, filtros e paginação |
/api/v1/paid/* | GET | Popule endpoints pagos para teste de agente-comprador x402 |
/api/v1/stats | GET | Estatísticas de nível de protocolo (volume, transações, afiliados) |
/api/v1/stats?type=affiliate&id=af_xxx | GET | Desempenho e ganhos de afiliados |
/api/v1/stats?type=vendor&id=vn_xxx | GET | Análises de vendedores |
/api/mcp | POST | Endpoint MCP JSON-RPC 2.0 (Streamable HTTP) |
/api/mcp | GET | Informações do servidor e definições de ferramentas |
Ferramentas MCP
| Ferramenta | Descrição |
|---|---|
pyrimid_browse | Buscar catálogo por consulta, preço, categoria, status verificado |
pyrimid_buy | Comprar um produto via x402 com atribuição de afiliado |
pyrimid_preview | Visualizar a divisão de comissão antes de comprar |
pyrimid_categories | Listar todas as categorias de produtos com contagens |
pyrimid_register_affiliate | Instruções para se registrar como afiliado onchain |
Arquitetura
pyrimid/
├── app/ # Next.js 15 (Vercel, region: bom1)
│ ├── page.tsx # Landing page
│ ├── dashboard/ # Protocol dashboard
│ └── api/
│ ├── v1/catalog/ # Aggregated product catalog
│ ├── v1/paid/ # Seed x402 paid endpoints
│ ├── v1/stats/ # Protocol & affiliate analytics
│ └── mcp/ # MCP JSON-RPC endpoint
├── sdk/ # @pyrimid/sdk (published to npm)
│ └── src/
│ ├── resolver.ts # PyrimidResolver — search, purchase, stats
│ ├── mcp-server.ts # MCP server factory
│ ├── middleware.ts # Vendor payment middleware + calculateSplit()
│ └── types.ts # ABIs, addresses, interfaces
├── subgraph/ # The Graph indexer (Base)
│ ├── schema.graphql # PaymentRouted, Affiliate, Vendor entities
│ ├── subgraph.yaml # 4 data sources
│ └── src/mapping.ts # Event handlers
├── middleware.ts # Edge rate limiting (60/min API, 120/min MCP)
└── public/docs/ # Developer documentation
Desenvolvimento
# Clone & install
git clone https://github.com/pyrimid/protocol.git
cd protocol
npm install
# Run locally
cp .env.example .env
npm run dev
# SDK development
cd sdk
npm run build # TypeScript → dist/
npm run dev # Watch mode
Implantar
# Website + API
npx vercel --prod
# SDK to npm
cd sdk && npm publish --access public
# Subgraph to The Graph
cd subgraph && npx graph deploy pyrimid --studio
Segurança
- Verificação de pagamento: Verificação onchain real via viem — verifica eventos
PaymentRouted+ transferências USDC com expiração de 5 minutos - Limite de taxa: Middleware de borda, 60 req/min por IP em catálogo/estatísticas, 120/min em MCP
- Segurança BigInt:
calculateSplit()lida com entradasNumbereBigIntde bibliotecas web3 - Padrão de contrato: Proxies atualizáveis ERC-1967 com código-fonte verificado no BaseScan
Roteiro
- Contratos principais implantados na Base
- SDK v0.2.3 com paginação completa do catálogo
- Servidor MCP com 5 ferramentas
- Agregação x402 Bazaar (92+ produtos)
- Indexação de subgrafo no The Graph
- Limite de taxa e endurecimento de segurança
- Verificação de identidade ERC-8004 para vendedores
- Suporte a múltiplas redes (Arbitrum, Optimism)
- Painel de receita para afiliados
- Portal de registro de autoatendimento para vendedores
Links
| Recurso | URL |
|---|---|
| Site | pyrimid.ai |
| Documentação | pyrimid.ai/docs |
| SDK | npmjs.com/package/@pyrimid/sdk |
| Subgrafo | thegraph.com/studio/subgraph/pyrimid |
| Registro | BaseScan |
| Roteador | BaseScan |
Construído na Base · Pagamentos via x402 · Liquidação em USDC