Engineering
pinion-fund avatar

pinion-fund

Check Base address ETH/USDC balances and receive step-by-step wallet funding instructions. Requires $0.01 USDC via x402 payment.

Introduction

The pinion-fund skill is an essential utility for software agents and developers operating on the Base L2 network. It provides automated, real-time insights into a wallet's financial readiness, allowing agents to verify if they possess sufficient liquidity to execute transactions, perform swaps, or pay for further x402-based skill calls. By returning precise balance data alongside actionable funding guidance, this skill serves as a gateway for onboarding or maintaining autonomous wallets that rely on ETH for gas fees and USDC for micropayment settlements.

  • Real-time balance retrieval for both ETH and USDC on the Base network (ChainID 8453).

  • Provision of step-by-step wallet funding instructions tailored to new or underfunded addresses.

  • Calculation of minimum recommended balances for gas fees and recurring operational costs.

  • Automated protocol integration with the x402 payment standard for seamless micropayment handling.

  • Compatibility with the Pinion OS SDK, enabling programmatic access for agents and developers.

  • Detailed guidance on bridging assets via the official Base bridge to ensure efficient capital flow.

  • Input requires a standard 40-character Ethereum address (0x format).

  • Each request incurs a $0.01 USDC fee settled via an EIP-3009 TransferWithAuthorization signature.

  • Recommended for agents that need to perform autonomous liquidity management before triggering heavy on-chain tasks.

  • Useful for debugging wallet status when downstream transactions fail due to insufficient gas (ETH) or fee assets (USDC).

  • Designed for use within the Pinion OS framework, but integrates with any system capable of handling x402 protocol handshake/retry flows.

  • Ensure the target wallet is properly initialized on the Base network to maximize efficiency of the recommended funding steps provided in the API response.

Repository Stats

Stars
98
Forks
7
Open Issues
1
Language
TypeScript
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 02:18 AM
View on GitHub