grid402-mcp 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,79 @@
1
- # Temporary Holding Version
1
+ # grid402-mcp ⚡
2
+
3
+ Servidor oficial do **Model Context Protocol (MCP)** para o **Grid402** — Hub de Utilitários de Rede e Dados Públicos Abertos com liquidação de micropagamentos x402 em USDC na rede Base.
4
+
5
+ Compatível nativamente com **Claude Desktop**, **Cursor**, **Smithery.ai** e qualquer orquestrador compatível com a especificação MCP da Anthropic.
6
+
7
+ ---
8
+
9
+ ## 🛠️ Ferramentas Disponíveis
10
+
11
+ | Ferramenta | Descrição | Modalidade | Custo |
12
+ |---|---|---|---|
13
+ | `grid402_summary` | Resumo consolidado de saúde dos 6 micro-serviços | Direto | Gratuito |
14
+ | `grid402_forex` | Cotações em tempo real de USD, EUR e GBP para BRL | On-Demand | 0.0005 USDC |
15
+ | `grid402_crypto` | Preços spot de BTC, ETH, SOL, USDC e BASE | On-Demand | 0.0005 USDC |
16
+ | `grid402_dns` | Resolução autoritativa de DNS (A, AAAA, MX, TXT, NS, CNAME) | On-Demand | 0.0005 USDC |
17
+ | `grid402_ssl` | Inspeção de validade, emissor e dias restantes de certificados TLS/SSL | On-Demand | 0.0005 USDC |
18
+ | `grid402_asn` | Inteligência BGP, número ASN, organização e país de bloco IP | On-Demand | 0.0005 USDC |
19
+ | `grid402_cep` | Consulta de endereço postal brasileiro e código IBGE oficial | On-Demand | 0.0005 USDC |
20
+
21
+ ---
22
+
23
+ ## 🚀 Como Configurar
24
+
25
+ ### 1. Claude Desktop
26
+ Adicione ao seu arquivo de configuração (`claude_desktop_config.json`):
27
+ - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
28
+ - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "grid402": {
34
+ "command": "npx",
35
+ "args": ["-y", "grid402-mcp"],
36
+ "env": {
37
+ "GRID402_ENDPOINT": "https://orangered-jackal-900744.hostingersite.com",
38
+ "GRID402_PRIVATE_KEY": "0xsua_chave_privada_base_aqui"
39
+ }
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ > 💡 **Nota de Segurança:** A variável `GRID402_PRIVATE_KEY` é opcional. Se informada, o servidor MCP realiza a transferência automática de 0.0005 USDC on-chain na Base a cada consulta paga. Se não for informada, o servidor retorna o desafio x402 em formato amigável. A chave é processada estritamente na sua máquina local e nunca é enviada ao servidor do Grid402.
46
+
47
+ ---
48
+
49
+ ### 2. Cursor IDE
50
+ No seu projeto ou globalmente em `~/.cursor/mcp.json`:
51
+ ```json
52
+ {
53
+ "mcpServers": {
54
+ "grid402": {
55
+ "command": "npx",
56
+ "args": ["-y", "grid402-mcp"]
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ ---
63
+
64
+ ### 3. Smithery.ai
65
+ Para instalar via Smithery CLI:
66
+ ```bash
67
+ smithery install grid402-mcp --client claude
68
+ ```
69
+
70
+ ---
71
+
72
+ ## 🧪 Testando Localmente
73
+ ```bash
74
+ cd mcp
75
+ node test_mcp.mjs
76
+ ```
77
+
78
+ Licença MIT • Grid402 Team
2
79
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
package/index.mjs ADDED
@@ -0,0 +1,110 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Grid402 Official Model Context Protocol (MCP) Server
5
+ * Exposes 7 tools for real-time open data and network utilities with Base x402 settlement.
6
+ */
7
+
8
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
9
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
10
+ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
11
+ import { MCP_TOOLS_DEFINITIONS, executeGrid402Request, DEFAULT_ENDPOINT } from './tools.mjs';
12
+
13
+ const server = new Server(
14
+ {
15
+ name: 'grid402-mcp-server',
16
+ version: '1.0.0',
17
+ },
18
+ {
19
+ capabilities: {
20
+ tools: {},
21
+ },
22
+ }
23
+ );
24
+
25
+ // 1. Registro do catálogo de ferramentas
26
+ server.setRequestHandler(ListToolsRequestSchema, async () => {
27
+ return {
28
+ tools: MCP_TOOLS_DEFINITIONS,
29
+ };
30
+ });
31
+
32
+ // 2. Registro do despachante de chamadas de ferramentas
33
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
34
+ const toolName = request.params.name;
35
+ const args = request.params.arguments || {};
36
+
37
+ try {
38
+ let service = '';
39
+ switch (toolName) {
40
+ case 'grid402_summary':
41
+ service = 'summary';
42
+ break;
43
+ case 'grid402_forex':
44
+ service = 'forex';
45
+ break;
46
+ case 'grid402_crypto':
47
+ service = 'crypto';
48
+ break;
49
+ case 'grid402_dns':
50
+ service = 'dns';
51
+ break;
52
+ case 'grid402_ssl':
53
+ service = 'ssl';
54
+ break;
55
+ case 'grid402_asn':
56
+ service = 'asn';
57
+ break;
58
+ case 'grid402_cep':
59
+ service = 'cep';
60
+ break;
61
+ case 'grid402_cnpj':
62
+ service = 'cnpj';
63
+ break;
64
+ default:
65
+ throw new Error(`Ferramenta MCP desconhecida: ${toolName}`);
66
+ }
67
+
68
+ const result = await executeGrid402Request(service, args);
69
+
70
+ return {
71
+ content: [
72
+ {
73
+ type: 'text',
74
+ text: JSON.stringify(result, null, 2),
75
+ },
76
+ ],
77
+ };
78
+ } catch (error) {
79
+ return {
80
+ content: [
81
+ {
82
+ type: 'text',
83
+ text: JSON.stringify(
84
+ {
85
+ error: 'ToolExecutionError',
86
+ tool: toolName,
87
+ message: error.message,
88
+ },
89
+ null,
90
+ 2
91
+ ),
92
+ },
93
+ ],
94
+ isError: true,
95
+ };
96
+ }
97
+ });
98
+
99
+ // 3. Inicialização do transporte Stdio
100
+ async function main() {
101
+ const transport = new StdioServerTransport();
102
+ await server.connect(transport);
103
+ process.stderr.write(`[Grid402 MCP] Servidor iniciado via stdio. Endpoint: ${DEFAULT_ENDPOINT}\n`);
104
+ }
105
+
106
+ main().catch((err) => {
107
+ process.stderr.write(`[Grid402 MCP] Erro fatal na inicialização: ${err.message}\n`);
108
+ process.exit(1);
109
+ });
110
+
package/package.json CHANGED
@@ -1,6 +1,42 @@
1
1
  {
2
2
  "name": "grid402-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.1.0",
4
+ "description": "Official Model Context Protocol (MCP) Server for Grid402 - Public Open Data e Network Utilities Hub (Forex, Crypto, DNS, SSL, ASN, CEP) with Base x402 micropayments.",
5
+ "type": "module",
6
+ "bin": {
7
+ "grid402-mcp": "index.mjs"
8
+ },
9
+ "main": "./index.mjs",
10
+ "scripts": {
11
+ "start": "node index.mjs",
12
+ "test": "node test_mcp.mjs"
13
+ },
14
+ "keywords": [
15
+ "mcp",
16
+ "model-context-protocol",
17
+ "claude",
18
+ "cursor",
19
+ "smithery",
20
+ "ai-agents",
21
+ "x402",
22
+ "base",
23
+ "usdc",
24
+ "forex",
25
+ "crypto",
26
+ "dns",
27
+ "ssl",
28
+ "asn",
29
+ "cep"
30
+ ],
31
+ "author": "Grid402 Team <contato@grid402.com.br>",
32
+ "license": "MIT",
33
+ "homepage": "https://www.grid402.com.br",
34
+ "repository": {
35
+ "type": "git",
36
+ "url": "git+https://github.com/oliveiratc/Grid402.git"
37
+ },
38
+ "dependencies": {
39
+ "@modelcontextprotocol/sdk": "^1.6.0",
40
+ "ethers": "^6.13.5"
41
+ }
42
+ }
package/smithery.yaml ADDED
@@ -0,0 +1,19 @@
1
+ name: "grid402-mcp"
2
+ version: 1.0.0
3
+ description: "Official Model Context Protocol (MCP) Server for Grid402 - Public Open Data e Network Utilities Hub (Forex, Crypto, DNS, SSL, ASN, CEP) with Base x402 micropayments."
4
+ startCommand:
5
+ type: stdio
6
+ config:
7
+ command: npx
8
+ args:
9
+ - "-y"
10
+ - "grid402-mcp"
11
+ env:
12
+ GRID402_ENDPOINT:
13
+ type: string
14
+ description: "Grid402 Hub API Endpoint"
15
+ default: "https://orangered-jackal-900744.hostingersite.com"
16
+ GRID402_PRIVATE_KEY:
17
+ type: string
18
+ description: "EVM private key on Base Mainnet for automated 0.0005 USDC x402 payment settlement (optional)"
19
+
package/test_mcp.mjs ADDED
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Grid402 MCP Server - Bateria de Testes Automatizados
3
+ */
4
+
5
+ import assert from 'node:assert';
6
+ import { MCP_TOOLS_DEFINITIONS, executeGrid402Request } from './tools.mjs';
7
+ import { settleX402Payment, GRID402_RECIPIENT_WALLET } from './x402_payer.mjs';
8
+
9
+ async function runTests() {
10
+ console.log('=== Testando Servidor MCP Grid402 ===\n');
11
+
12
+ // 1. Validação de Schemas das Ferramentas
13
+ console.log('[1/4] Validando registro e schemas das 8 ferramentas MCP...');
14
+ assert.strictEqual(MCP_TOOLS_DEFINITIONS.length, 8, 'Deve conter exatamente 8 ferramentas registradas');
15
+
16
+ const toolNames = MCP_TOOLS_DEFINITIONS.map(t => t.name);
17
+ const expectedTools = [
18
+ 'grid402_summary',
19
+ 'grid402_forex',
20
+ 'grid402_crypto',
21
+ 'grid402_dns',
22
+ 'grid402_ssl',
23
+ 'grid402_asn',
24
+ 'grid402_cep',
25
+ 'grid402_cnpj',
26
+ ];
27
+
28
+ for (const expected of expectedTools) {
29
+ assert.ok(toolNames.includes(expected), `Ferramenta ${expected} deve estar presente`);
30
+ }
31
+ console.log(' ✓ Todas as 8 ferramentas MCP validadas com sucesso!');
32
+
33
+ // 2. Teste de Consulta Gratuita (summary)
34
+ console.log('\n[2/4] Testando consulta à ferramenta gratuita grid402_summary...');
35
+ const summary = await executeGrid402Request('summary');
36
+ assert.strictEqual(summary.protocol, 'x402', 'Protocolo deve ser x402');
37
+ assert.strictEqual(summary.hub, 'Grid402', 'Hub deve ser Grid402');
38
+ assert.ok(summary.services, 'Deve conter catálogo de serviços');
39
+ console.log(' ✓ Resumo de saúde recebido com sucesso (Hub operacional)');
40
+
41
+ // 3. Teste de Captura de Desafio x402 sem Chave Privada
42
+ console.log('\n[3/4] Testando resposta de desafio 402 para consulta detalhada (grid402_dns e grid402_cnpj)...');
43
+ const dnsChallenge = await executeGrid402Request('dns', { domain: 'github.com' });
44
+ assert.strictEqual(dnsChallenge.payment_required, true, 'Deve indicar payment_required: true');
45
+ assert.ok(dnsChallenge.challenge, 'Deve conter objeto challenge');
46
+ assert.strictEqual(
47
+ (dnsChallenge.challenge.recipient_wallet || '').toLowerCase(),
48
+ GRID402_RECIPIENT_WALLET,
49
+ 'Carteira recebedora deve coincidir com a oficial'
50
+ );
51
+
52
+ const cnpjChallenge = await executeGrid402Request('cnpj', { cnpj: '00000000000191' });
53
+ assert.strictEqual(cnpjChallenge.payment_required, true, 'CNPJ deve indicar payment_required: true');
54
+ assert.ok(cnpjChallenge.challenge, 'Deve conter desafio estruturado');
55
+ console.log(' ✓ Desafio x402 capturado com instruções e carteira oficial para DNS e CNPJ!');
56
+
57
+ // 4. Teste de Validação Defensiva de Chave Privada
58
+ console.log('\n[4/4] Testando validação defensiva de formato de chave privada...');
59
+ try {
60
+ await settleX402Payment({}, 'chave_invalida');
61
+ assert.fail('Deveria ter lançado erro para chave inválida');
62
+ } catch (err) {
63
+ assert.ok(err.message.includes('Chave privada inválida'), 'Deve rejeitar chave mal formatada');
64
+ console.log(' ✓ Rejeição de chave privada inválida validada com sucesso!');
65
+ }
66
+
67
+ console.log('\n=== Todos os testes do MCP Server Grid402 foram APROVADOS com 100% de sucesso! ===');
68
+ }
69
+
70
+ runTests().catch(err => {
71
+ console.error('\n❌ Falha no teste do MCP Server:', err);
72
+ process.exit(1);
73
+ });
74
+
package/tools.mjs ADDED
@@ -0,0 +1,257 @@
1
+ /**
2
+ * Grid402 MCP Server - Catálogo de Ferramentas e Despachador HTTP
3
+ */
4
+
5
+ import { settleX402Payment } from './x402_payer.mjs';
6
+
7
+ export const DEFAULT_ENDPOINT = process.env.GRID402_ENDPOINT || 'https://orangered-jackal-900744.hostingersite.com';
8
+
9
+ /**
10
+ * Definições formais das 7 ferramentas no padrão MCP
11
+ */
12
+ export const MCP_TOOLS_DEFINITIONS = [
13
+ {
14
+ name: 'grid402_summary',
15
+ description: 'Consulta o resumo consolidado de saúde e disponibilidade dos 6 micro-serviços do Grid402 (gratuito, sem cobrança x402).',
16
+ inputSchema: {
17
+ type: 'object',
18
+ properties: {},
19
+ required: [],
20
+ },
21
+ },
22
+ {
23
+ name: 'grid402_forex',
24
+ description: 'Consulta cotações fiduciárias oficiais em tempo real de USD, EUR e GBP para BRL com variação percentual diária.',
25
+ inputSchema: {
26
+ type: 'object',
27
+ properties: {
28
+ payment_tx_hash: {
29
+ type: 'string',
30
+ description: 'Hash opcional de transação na Base Mainnet comprovando o pagamento de 0.0005 USDC caso não utilize liquidação automática.',
31
+ },
32
+ },
33
+ required: [],
34
+ },
35
+ },
36
+ {
37
+ name: 'grid402_crypto',
38
+ description: 'Consulta preços de mercado spot em tempo real de BTC, ETH, SOL, USDC e BASE em USD e BRL.',
39
+ inputSchema: {
40
+ type: 'object',
41
+ properties: {
42
+ payment_tx_hash: {
43
+ type: 'string',
44
+ description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
45
+ },
46
+ },
47
+ required: [],
48
+ },
49
+ },
50
+ {
51
+ name: 'grid402_dns',
52
+ description: 'Executa resolução DNS autoritativa de registros A, AAAA, MX, TXT, NS e CNAME para qualquer domínio da internet.',
53
+ inputSchema: {
54
+ type: 'object',
55
+ properties: {
56
+ domain: {
57
+ type: 'string',
58
+ description: 'Nome do domínio a ser consultado (ex: "github.com", "base.org").',
59
+ },
60
+ payment_tx_hash: {
61
+ type: 'string',
62
+ description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
63
+ },
64
+ },
65
+ required: ['domain'],
66
+ },
67
+ },
68
+ {
69
+ name: 'grid402_ssl',
70
+ description: 'Inspeciona e valida o certificado TLS/SSL na porta 443 de um host (emissor, validade, SANs e contagem de dias restantes até expirar).',
71
+ inputSchema: {
72
+ type: 'object',
73
+ properties: {
74
+ host: {
75
+ type: 'string',
76
+ description: 'Hostname ou domínio alvo para inspeção TLS (ex: "base.org", "google.com").',
77
+ },
78
+ payment_tx_hash: {
79
+ type: 'string',
80
+ description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
81
+ },
82
+ },
83
+ required: ['host'],
84
+ },
85
+ },
86
+ {
87
+ name: 'grid402_asn',
88
+ description: 'Consulta inteligência de rede BGP, identificando número de ASN, bloco IP alocado, provedor/organização e país de origem.',
89
+ inputSchema: {
90
+ type: 'object',
91
+ properties: {
92
+ ip: {
93
+ type: 'string',
94
+ description: 'Endereço IPv4 ou IPv6 a inspecionar (ex: "1.1.1.1"). Se omitido, consulta o IP público do requisitante.',
95
+ },
96
+ payment_tx_hash: {
97
+ type: 'string',
98
+ description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
99
+ },
100
+ },
101
+ required: [],
102
+ },
103
+ },
104
+ {
105
+ name: 'grid402_cep',
106
+ description: 'Consulta a base pública de endereçamento postal brasileiro retornando logradouro, bairro, município, UF e código IBGE oficial.',
107
+ inputSchema: {
108
+ type: 'object',
109
+ properties: {
110
+ code: {
111
+ type: 'string',
112
+ description: 'Código de CEP brasileiro com 8 dígitos numéricos (ex: "01310100" para Av. Paulista).',
113
+ },
114
+ payment_tx_hash: {
115
+ type: 'string',
116
+ description: 'Hash opcional de transação na Base Mainnet com 0.0005 USDC.',
117
+ },
118
+ },
119
+ required: ['code'],
120
+ },
121
+ },
122
+ {
123
+ name: 'grid402_cnpj',
124
+ description: 'Consulta dados cadastrais públicos de Pessoa Jurídica da Receita Federal (razão social, nome fantasia, situação cadastral, CNAE, endereço e capital social). Requer 0.0020 USDC.',
125
+ inputSchema: {
126
+ type: 'object',
127
+ properties: {
128
+ cnpj: {
129
+ type: 'string',
130
+ description: 'Número de CNPJ com 14 dígitos com ou sem formatação (ex: "00.000.000/0001-91" ou "00000000000191").',
131
+ },
132
+ payment_tx_hash: {
133
+ type: 'string',
134
+ description: 'Hash opcional de transação na Base Mainnet com 0.0020 USDC.',
135
+ },
136
+ },
137
+ required: ['cnpj'],
138
+ },
139
+ },
140
+ ];
141
+
142
+ /**
143
+ * Despachante de requisição HTTP com liquidação automática de desafio x402
144
+ */
145
+ export async function executeGrid402Request(service, params = {}, options = {}) {
146
+ const endpoint = (options.endpoint || DEFAULT_ENDPOINT).replace(/\/$/, '');
147
+ const privateKey = options.privateKey || process.env.GRID402_PRIVATE_KEY || null;
148
+ const preferredRpc = options.rpcUrl || process.env.GRID402_BASE_RPC_URL || null;
149
+
150
+ let path = '';
151
+ const queryParams = new URLSearchParams();
152
+
153
+ switch (service) {
154
+ case 'summary':
155
+ path = '/status';
156
+ break;
157
+ case 'forex':
158
+ path = '/api/v1/forex';
159
+ break;
160
+ case 'crypto':
161
+ path = '/api/v1/crypto';
162
+ break;
163
+ case 'dns':
164
+ path = '/api/v1/dns';
165
+ if (params.domain) queryParams.set('domain', params.domain);
166
+ break;
167
+ case 'ssl':
168
+ path = '/api/v1/ssl';
169
+ if (params.host) queryParams.set('host', params.host);
170
+ break;
171
+ case 'asn':
172
+ path = '/api/v1/asn';
173
+ if (params.ip) queryParams.set('ip', params.ip);
174
+ break;
175
+ case 'cep':
176
+ path = '/api/v1/cep';
177
+ if (params.code) queryParams.set('code', params.code);
178
+ break;
179
+ case 'cnpj':
180
+ path = '/api/v1/cnpj';
181
+ if (params.cnpj) queryParams.set('cnpj', params.cnpj);
182
+ break;
183
+ default:
184
+ throw new Error(`Serviço desconhecido: ${service}`);
185
+ }
186
+
187
+ const queryString = queryParams.toString();
188
+ const url = `${endpoint}${path}${queryString ? '?' + queryString : ''}`;
189
+
190
+ const headers = {
191
+ 'Accept': 'application/json',
192
+ 'User-Agent': 'Grid402-MCP-Server/1.0',
193
+ };
194
+
195
+ if (params.payment_tx_hash) {
196
+ headers['X-Payment'] = params.payment_tx_hash;
197
+ }
198
+
199
+ // 1. Primeira tentativa de requisição
200
+ const response = await fetch(url, { headers });
201
+
202
+ if (response.status === 200) {
203
+ return await response.json();
204
+ }
205
+
206
+ // 2. Se retornou 402 Payment Required
207
+ if (response.status === 402) {
208
+ const challenge = await response.json();
209
+
210
+ // Se temos uma chave privada configurada, tenta pagamento on-chain automático
211
+ if (privateKey) {
212
+ try {
213
+ const paymentResult = await settleX402Payment(challenge, privateKey, preferredRpc);
214
+
215
+ // Refaz a requisição com o hash da transação confirmada na Base
216
+ headers['X-Payment'] = paymentResult.txHash;
217
+ const retryResponse = await fetch(url, { headers });
218
+
219
+ if (retryResponse.status === 200) {
220
+ const data = await retryResponse.json();
221
+ return {
222
+ ...data,
223
+ _x402_settlement: {
224
+ status: 'CONFIRMED_ON_CHAIN',
225
+ network: 'Base',
226
+ tx_hash: paymentResult.txHash,
227
+ block_number: paymentResult.blockNumber,
228
+ amount_usdc: paymentResult.amountUsdc,
229
+ },
230
+ };
231
+ }
232
+ } catch (payError) {
233
+ return {
234
+ payment_required: true,
235
+ error: `Falha na liquidação automática do pagamento x402: ${payError.message}`,
236
+ challenge,
237
+ };
238
+ }
239
+ }
240
+
241
+ // Se não há chave privada configurada, retorna o desafio de pagamento estruturado
242
+ return {
243
+ payment_required: true,
244
+ message: 'Esta consulta requer micropagamento de 0.0005 USDC na rede Base via protocolo x402.',
245
+ challenge,
246
+ instructions: 'Para liquidação automática, defina a variável de ambiente GRID402_PRIVATE_KEY no seu arquivo de configuração MCP.',
247
+ };
248
+ }
249
+
250
+ const errText = await response.text();
251
+ try {
252
+ return JSON.parse(errText);
253
+ } catch {
254
+ throw new Error(`Erro na API Grid402 (HTTP ${response.status}): ${errText}`);
255
+ }
256
+ }
257
+
package/x402_payer.mjs ADDED
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Grid402 MCP Server - Módulo de Liquidação x402 On-Chain (Base Mainnet)
3
+ *
4
+ * Permite pagamentos automáticos de US$ 0.0005 USDC via transferência ERC-20
5
+ * quando uma chave privada é fornecida no ambiente do agente.
6
+ */
7
+
8
+ import { ethers } from 'ethers';
9
+
10
+ export const BASE_RPC_URLS = [
11
+ 'https://mainnet.base.org',
12
+ 'https://1rpc.io/base',
13
+ 'https://base.llamarpc.com',
14
+ ];
15
+
16
+ export const USDC_CONTRACT_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'.toLowerCase();
17
+ export const GRID402_RECIPIENT_WALLET = '0xa31c31069c43ac1c0075a93c325b0dcd7744356c'.toLowerCase();
18
+ export const REQUIRED_RAW_UNITS = 500n; // 0.000500 USDC (6 casas decimais)
19
+
20
+ const ERC20_ABI = [
21
+ 'function transfer(address to, uint256 amount) returns (bool)',
22
+ 'function balanceOf(address account) view returns (uint256)',
23
+ ];
24
+
25
+ /**
26
+ * Cria um provider com fallback resiliente para a Base Mainnet
27
+ */
28
+ export async function getBaseProvider(preferredRpc = null) {
29
+ const rpcs = preferredRpc ? [preferredRpc, ...BASE_RPC_URLS] : BASE_RPC_URLS;
30
+ for (const rpc of rpcs) {
31
+ try {
32
+ const provider = new ethers.JsonRpcProvider(rpc, 8453, { staticNetwork: true });
33
+ await provider.getBlockNumber();
34
+ return provider;
35
+ } catch {
36
+ // Tenta próximo RPC
37
+ }
38
+ }
39
+ throw new Error('Não foi possível conectar a nenhum nó RPC da Base Mainnet.');
40
+ }
41
+
42
+ /**
43
+ * Executa a transferência de 0.0005 USDC na Base para liquidar o desafio x402
44
+ *
45
+ * @param {object} challenge Desafio retornado pelo Grid402 (HTTP 402)
46
+ * @param {string} privateKey Chave privada hexadecimal da carteira pagadora
47
+ * @param {string} [preferredRpc] URL opcional de RPC da Base
48
+ * @returns {Promise<{ txHash: string, blockNumber: number }>}
49
+ */
50
+ export async function settleX402Payment(challenge, privateKey, preferredRpc = null) {
51
+ if (!privateKey || typeof privateKey !== 'string' || !privateKey.startsWith('0x')) {
52
+ throw new Error('Chave privada inválida. Deve iniciar com 0x e conter 64 caracteres hexadecimais.');
53
+ }
54
+
55
+ const recipient = (challenge?.recipient_wallet || GRID402_RECIPIENT_WALLET).toLowerCase();
56
+ const tokenContract = (challenge?.token_contract || USDC_CONTRACT_BASE).toLowerCase();
57
+ const rawUnits = BigInt(challenge?.price_raw_units || REQUIRED_RAW_UNITS);
58
+
59
+ const provider = await getBaseProvider(preferredRpc);
60
+ const wallet = new ethers.Wallet(privateKey, provider);
61
+
62
+ // Instancia contrato ERC-20 do USDC na Base
63
+ const usdc = new ethers.Contract(tokenContract, ERC20_ABI, wallet);
64
+
65
+ // 1. Verifica saldo de USDC
66
+ try {
67
+ const balance = await usdc.balanceOf(wallet.address);
68
+ if (balance < rawUnits) {
69
+ throw new Error(`Saldo insuficiente de USDC na carteira ${wallet.address}. Requerido: 0.0005 USDC, Atual: ${ethers.formatUnits(balance, 6)} USDC.`);
70
+ }
71
+ } catch (err) {
72
+ if (err.message.includes('Saldo insuficiente')) {
73
+ throw err;
74
+ }
75
+ // Caso leitura falhe por RPC restrito, tenta envio direto
76
+ }
77
+
78
+ // 2. Envia transferência ERC-20
79
+ const tx = await usdc.transfer(recipient, rawUnits);
80
+ const receipt = await tx.wait(1);
81
+
82
+ return {
83
+ txHash: receipt.hash,
84
+ blockNumber: receipt.blockNumber,
85
+ from: wallet.address,
86
+ to: recipient,
87
+ amountUsdc: '0.0005',
88
+ };
89
+ }
90
+