agentwallet-mcp 1.10.5 → 1.10.6

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.
Files changed (2) hide show
  1. package/build/index.js +75 -75
  2. package/package.json +1 -1
package/build/index.js CHANGED
@@ -424,82 +424,82 @@ function resolveChainId(network) {
424
424
  const AddressSchema = z.string().regex(/^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$/, 'Must be a 0x-prefixed 40-hex EVM address or a base58 Solana address');
425
425
  const server = new McpServer({
426
426
  name: 'agentwallet',
427
- version: '1.10.4',
427
+ version: '1.10.6',
428
428
  }, {
429
- instructions: `AgentWallet gives AI agents their own blockchain wallets. Private keys are encrypted server-side and never exposed — agents sign and broadcast transactions without ever touching raw keys.
430
-
431
- ## Getting Started
432
- 1. Call list_wallets to see existing wallets, or create_wallet to make a new one.
433
- 2. Fund the wallet by sending tokens to its address from an external source.
434
- 3. Use transfer (native tokens) or transfer_token (ERC-20/SPL tokens) to send funds.
435
-
436
- ## Supported Chains
437
- - **EVM chains:** Ethereum (1), Base (8453), Arbitrum (42161), Optimism (10), Polygon (137), Avalanche (43114), BSC (56), Zora (7777777), PulseChain (369)
438
- - **Solana:** Mainnet (900), Devnet (901)
439
- - Call get_chains for the full list with native tokens and stablecoin contract addresses.
440
-
441
- ## EVM vs Solana
442
- - **Addresses:** EVM uses 0x-prefixed hex (42 chars). Solana uses Base58 (32-44 chars).
443
- - **Native tokens:** EVM = ETH/POL/BNB/etc (18 decimals, wei). Solana = SOL (9 decimals, lamports).
444
- - **Token standards:** EVM uses ERC-20. Solana uses SPL tokens.
445
- - **EVM-only tools:** approve_token, get_allowance, wrap_eth, unwrap_eth, call_contract, get_token_info. These do not work on Solana.
446
- - **Works on both:** create_wallet, transfer, transfer_token, send_transaction, sign_transaction, get_balance, get_token_balance.
447
-
448
- ## Common Workflows
449
-
450
- ### Send native tokens (ETH, SOL, etc.)
451
- Use the transfer tool with a human-readable amount (e.g. "0.1" ETH). It auto-converts to wei/lamports.
452
-
453
- ### Send ERC-20 or SPL tokens
454
- Use transfer_token. You need: wallet_id, token contract address, recipient, amount, chain_id, and decimals (6 for USDC, 18 for most ERC-20s). Call get_chains to find stablecoin addresses.
455
-
456
- ### Interact with DeFi (EVM only)
457
- 1. Check allowance with get_allowance.
458
- 2. If needed, call approve_token to let the DeFi contract spend your tokens.
459
- 3. Use send_transaction with the contract's calldata to execute the interaction.
460
-
461
- ### Wrap/unwrap native tokens (EVM only)
462
- Use wrap_eth to convert ETH → WETH (required by many DeFi protocols). Use unwrap_eth to convert back.
463
-
464
- ### Read on-chain data (EVM only)
465
- Use call_contract for gas-free read-only calls (eth_call). Provide ABI-encoded calldata.
466
-
467
- ## x402 Payments — Paying for Resources
468
- The pay_x402 tool handles the full x402 payment flow automatically:
469
- 1. Fetches the URL.
470
- 2. If the server returns HTTP 402, parses the payment requirements.
471
- 3. Pays on-chain using your wallet.
472
- 4. Retries the request with proof of payment.
473
- Always set max_payment to prevent overspending (e.g. "1.00" for max 1 USDC).
474
-
475
- ## x402 Paywalls — Accepting Payments
476
- Create paywalls to charge other agents for accessing your resources:
477
- 1. create_paywall — set price, token, chain, and the resource URL to protect.
478
- 2. Share the access URL. Clients that pay on-chain get the resource; others get HTTP 402.
479
- 3. list_paywalls and get_paywall_payments to track revenue.
480
- 4. get_x402_revenue for aggregate stats across all paywalls.
481
-
482
- ## Wallet Security
483
- - Use pause_wallet to immediately freeze a wallet if compromised. No transactions can be signed while paused.
484
- - Use unpause_wallet to resume operations.
485
- - Use delete_wallet to permanently disable a wallet.
486
- - Wallets have server-enforced spending limits.
487
-
488
- ## Tool Selection Guide
489
- | Goal | Tool |
490
- |------|------|
491
- | Send ETH/SOL/native tokens | transfer |
492
- | Send USDC/ERC-20/SPL tokens | transfer_token |
493
- | Check native balance | get_balance |
494
- | Check token balance | get_token_balance |
495
- | Look up token details | get_token_info (EVM only) |
496
- | Approve DeFi spending | approve_token (EVM only) |
497
- | Check approval amount | get_allowance (EVM only) |
498
- | Read smart contract | call_contract (EVM only) |
499
- | Custom transaction | send_transaction |
500
- | Sign without broadcasting | sign_transaction |
501
- | Pay for x402 resource | pay_x402 |
502
- | Charge for your resource | create_paywall |
429
+ instructions: `AgentWallet gives AI agents their own blockchain wallets. Private keys are encrypted server-side and never exposed — agents sign and broadcast transactions without ever touching raw keys.
430
+
431
+ ## Getting Started
432
+ 1. Call list_wallets to see existing wallets, or create_wallet to make a new one.
433
+ 2. Fund the wallet by sending tokens to its address from an external source.
434
+ 3. Use transfer (native tokens) or transfer_token (ERC-20/SPL tokens) to send funds.
435
+
436
+ ## Supported Chains
437
+ - **EVM chains:** Ethereum (1), Base (8453), Arbitrum (42161), Optimism (10), Polygon (137), Avalanche (43114), BSC (56), Zora (7777777), PulseChain (369)
438
+ - **Solana:** Mainnet (900), Devnet (901)
439
+ - Call get_chains for the full list with native tokens and stablecoin contract addresses.
440
+
441
+ ## EVM vs Solana
442
+ - **Addresses:** EVM uses 0x-prefixed hex (42 chars). Solana uses Base58 (32-44 chars).
443
+ - **Native tokens:** EVM = ETH/POL/BNB/etc (18 decimals, wei). Solana = SOL (9 decimals, lamports).
444
+ - **Token standards:** EVM uses ERC-20. Solana uses SPL tokens.
445
+ - **EVM-only tools:** approve_token, get_allowance, wrap_eth, unwrap_eth, call_contract, get_token_info. These do not work on Solana.
446
+ - **Works on both:** create_wallet, transfer, transfer_token, send_transaction, sign_transaction, get_balance, get_token_balance.
447
+
448
+ ## Common Workflows
449
+
450
+ ### Send native tokens (ETH, SOL, etc.)
451
+ Use the transfer tool with a human-readable amount (e.g. "0.1" ETH). It auto-converts to wei/lamports.
452
+
453
+ ### Send ERC-20 or SPL tokens
454
+ Use transfer_token. You need: wallet_id, token contract address, recipient, amount, chain_id, and decimals (6 for USDC, 18 for most ERC-20s). Call get_chains to find stablecoin addresses.
455
+
456
+ ### Interact with DeFi (EVM only)
457
+ 1. Check allowance with get_allowance.
458
+ 2. If needed, call approve_token to let the DeFi contract spend your tokens.
459
+ 3. Use send_transaction with the contract's calldata to execute the interaction.
460
+
461
+ ### Wrap/unwrap native tokens (EVM only)
462
+ Use wrap_eth to convert ETH → WETH (required by many DeFi protocols). Use unwrap_eth to convert back.
463
+
464
+ ### Read on-chain data (EVM only)
465
+ Use call_contract for gas-free read-only calls (eth_call). Provide ABI-encoded calldata.
466
+
467
+ ## x402 Payments — Paying for Resources
468
+ The pay_x402 tool handles the full x402 payment flow automatically:
469
+ 1. Fetches the URL.
470
+ 2. If the server returns HTTP 402, parses the payment requirements.
471
+ 3. Pays on-chain using your wallet.
472
+ 4. Retries the request with proof of payment.
473
+ Always set max_payment to prevent overspending (e.g. "1.00" for max 1 USDC).
474
+
475
+ ## x402 Paywalls — Accepting Payments
476
+ Create paywalls to charge other agents for accessing your resources:
477
+ 1. create_paywall — set price, token, chain, and the resource URL to protect.
478
+ 2. Share the access URL. Clients that pay on-chain get the resource; others get HTTP 402.
479
+ 3. list_paywalls and get_paywall_payments to track revenue.
480
+ 4. get_x402_revenue for aggregate stats across all paywalls.
481
+
482
+ ## Wallet Security
483
+ - Use pause_wallet to immediately freeze a wallet if compromised. No transactions can be signed while paused.
484
+ - Use unpause_wallet to resume operations.
485
+ - Use delete_wallet to permanently disable a wallet.
486
+ - Wallets have server-enforced spending limits.
487
+
488
+ ## Tool Selection Guide
489
+ | Goal | Tool |
490
+ |------|------|
491
+ | Send ETH/SOL/native tokens | transfer |
492
+ | Send USDC/ERC-20/SPL tokens | transfer_token |
493
+ | Check native balance | get_balance |
494
+ | Check token balance | get_token_balance |
495
+ | Look up token details | get_token_info (EVM only) |
496
+ | Approve DeFi spending | approve_token (EVM only) |
497
+ | Check approval amount | get_allowance (EVM only) |
498
+ | Read smart contract | call_contract (EVM only) |
499
+ | Custom transaction | send_transaction |
500
+ | Sign without broadcasting | sign_transaction |
501
+ | Pay for x402 resource | pay_x402 |
502
+ | Charge for your resource | create_paywall |
503
503
  | Check usage/billing | get_usage |`,
504
504
  });
505
505
  // ─── Tool: create_wallet ─────────────────────────────────────────
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agentwallet-mcp",
3
3
  "mcpName": "io.github.hifriendbot/agentwallet",
4
- "version": "1.10.5",
4
+ "version": "1.10.6",
5
5
  "description": "MCP server for AgentWallet: self-custody local signing on EVM and Solana, or hosted wallets. Sign, broadcast, pay x402 invoices, and accept x402 payments.",
6
6
  "type": "module",
7
7
  "main": "build/index.js",