Getting Started
First Wallet
Create a chain wallet, register plugins, and expose tools.
Step 1: Install Packages
Install the core package and your target chain package:
npm install @agentic-wallet/core @agentic-wallet/solana
# or
bun add @agentic-wallet/core @agentic-wallet/solanaStep 2: Create a Wallet
Instantiate the chain wallet:
import { SolanaAgentWallet, createKeypairProvider } from '@agentic-wallet/solana';
const wallet = new SolanaAgentWallet({
rpcUrl: 'https://api.devnet.solana.com',
provider: createKeypairProvider(process.env.SOLANA_PRIVATE_KEY!),
});
console.log('Wallet address:', wallet.address);Step 3: Register Plugins
Add functionality with plugins:
import { jupiterPlugin } from '@agentic-wallet/solana/plugin';
const wallet = new SolanaAgentWallet({
rpcUrl: 'https://api.devnet.solana.com',
provider: createKeypairProvider(process.env.SOLANA_PRIVATE_KEY!),
}).use(jupiterPlugin({
apiKey: process.env.JUPITER_API_KEY,
}));Available plugins:
- pumpfun - Token creation, bonding curve trading
- jupiter - Token swaps, limit orders, DCA, lending
- raydium - Liquidity pools, farms, staking (WIP)
- sns - .sol domain names
Step 4: Expose Tools
Get tools for your agent framework:
const tools = wallet.getTools();
console.log('Available tools:', tools.map(t => t.name));Quick Examples
Swap Tokens
const result = await wallet.methods.jupiterSwap({
inputMint: 'So11111111111111111111111111111111111111112', // SOL
outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
amount: '1',
});
console.log('Swap signature:', result.signature);Get Token Price
const prices = await wallet.methods.jupiterGetTokenPrice({
mints: ['EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'],
});
console.log('USDC price:', prices['EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v']?.usdPrice);