polygon-agent-kit

What This Skill Does

The polygon-agent-kit is a sophisticated command-line toolkit designed for developers and autonomous agents interacting with the Polygon ecosystem. It serves as a unified interface for managing session-based smart contract wallets, executing token operations (swap, bridge, send, deposit), and maintaining on-chain identity via ERC-8004. By leveraging Sequence for wallet management and Trails for asset movement, it abstracts away the complexities of blockchain transactions. Key features include AES-256-GCM encrypted local storage for security, automated ecosystem wallet creation with granular spending limits, and robust support for x402 micropayments. It is built to facilitate everything from simple balance tracking to complex, agentic on-chain reputation systems.

Installation

To begin, ensure you have Node.js 20+ installed on your system. You can install the tool globally via npm: npm install -g github:0xPolygon/polygon-agent-kit Once installed, you must perform the initial setup using the polygon-agent setup --name "MyAgent" command. This will generate your EOA, create your Sequence project, and initialize the encrypted storage directory at ~/.polygon-agent/. Ensure you store your private key securely, as it will not be displayed again.

Use Cases

• Autonomous Trading Agents: Automate token swaps and bridge assets across chains using defined spending limits for safety.
• Micropayment Infrastructure: Implement x402 payment flows for services requiring on-chain validation.
• On-chain Reputation Management: Register your AI agent as an ERC-8004 identity to build and track performance-based reputation on the Polygon mainnet.
• Secure Wallet Orchestration: Manage ecosystem wallets for separate sub-agents with individual contract whitelists and asset constraints.

Example Prompts

1. "Initialize my new autonomous trading agent and set up the ecosystem wallet with a 50 USDC spending limit."
2. "Check the current balances for my agent and bridge 10 MATIC to the Polygon mainnet for upcoming transaction fees."
3. "Register my agent 'AlphaTrader' on-chain using the ERC-8004 standard so I can begin tracking its performance metrics."

Tips & Limitations

• Security: Always keep your SEQUENCE_PROJECT_ACCESS_KEY and private keys in a secure environment variable manager. Do not commit these to source control.
• Limits: Make full use of the --usdc-limit and --native-limit flags when creating wallets to ensure your agent acts within a sandbox if compromised.
• Debugging: If transactions fail, enable POLYGON_AGENT_DEBUG_FETCH=true to inspect HTTP interactions in your log directory.