agentwallet-sdk 6.0.4 → 6.0.5
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 +296 -332
- package/dist/bridge/__tests__/solana.test.js +1 -1
- package/dist/bridge/__tests__/solana.test.js.map +1 -1
- package/dist/escrow/MutualStakeEscrow.d.ts.map +1 -1
- package/dist/escrow/MutualStakeEscrow.js +3 -5
- package/dist/escrow/MutualStakeEscrow.js.map +1 -1
- package/dist/index.d.ts +48 -252
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +13 -5
- package/dist/index.js.map +1 -1
- package/dist/policy/SpendingPolicy.test.js.map +1 -1
- package/dist/swap/SwapModule.js +1 -1
- package/dist/swap/SwapModule.js.map +1 -1
- package/dist/tokens/__tests__/decimals.test.d.ts +2 -0
- package/dist/tokens/__tests__/decimals.test.d.ts.map +1 -0
- package/dist/tokens/__tests__/decimals.test.js +107 -0
- package/dist/tokens/__tests__/decimals.test.js.map +1 -0
- package/dist/tokens/__tests__/registry.test.d.ts +2 -0
- package/dist/tokens/__tests__/registry.test.d.ts.map +1 -0
- package/dist/tokens/__tests__/registry.test.js +191 -0
- package/dist/tokens/__tests__/registry.test.js.map +1 -0
- package/dist/tokens/__tests__/transfers.test.d.ts +2 -0
- package/dist/tokens/__tests__/transfers.test.d.ts.map +1 -0
- package/dist/tokens/__tests__/transfers.test.js +103 -0
- package/dist/tokens/__tests__/transfers.test.js.map +1 -0
- package/dist/tokens/decimals.d.ts +65 -0
- package/dist/tokens/decimals.d.ts.map +1 -0
- package/dist/tokens/decimals.js +112 -0
- package/dist/tokens/decimals.js.map +1 -0
- package/dist/tokens/index.d.ts +14 -0
- package/dist/tokens/index.d.ts.map +1 -0
- package/dist/tokens/index.js +14 -0
- package/dist/tokens/index.js.map +1 -0
- package/dist/tokens/registry.d.ts +82 -0
- package/dist/tokens/registry.d.ts.map +1 -0
- package/dist/tokens/registry.js +293 -0
- package/dist/tokens/registry.js.map +1 -0
- package/dist/tokens/solana.d.ts +108 -0
- package/dist/tokens/solana.d.ts.map +1 -0
- package/dist/tokens/solana.js +306 -0
- package/dist/tokens/solana.js.map +1 -0
- package/dist/tokens/transfers.d.ts +95 -0
- package/dist/tokens/transfers.d.ts.map +1 -0
- package/dist/tokens/transfers.js +196 -0
- package/dist/tokens/transfers.js.map +1 -0
- package/dist/x402/chains/abstract/index.d.ts.map +1 -1
- package/dist/x402/chains/abstract/index.js.map +1 -1
- package/dist/x402/chains/stellar/index.d.ts.map +1 -1
- package/dist/x402/chains/stellar/index.js +2 -0
- package/dist/x402/chains/stellar/index.js.map +1 -1
- package/dist/x402/client.d.ts +7 -1
- package/dist/x402/client.d.ts.map +1 -1
- package/dist/x402/client.js +24 -13
- package/dist/x402/client.js.map +1 -1
- package/dist/x402/index.d.ts +1 -0
- package/dist/x402/index.d.ts.map +1 -1
- package/dist/x402/index.js +2 -0
- package/dist/x402/index.js.map +1 -1
- package/dist/x402/middleware.d.ts.map +1 -1
- package/dist/x402/middleware.js +0 -3
- package/dist/x402/middleware.js.map +1 -1
- package/dist/x402/multi-asset.d.ts +54 -0
- package/dist/x402/multi-asset.d.ts.map +1 -0
- package/dist/x402/multi-asset.js +123 -0
- package/dist/x402/multi-asset.js.map +1 -0
- package/package.json +12 -3
- package/dist/plugins/elizaos.d.ts +0 -52
- package/dist/plugins/elizaos.d.ts.map +0 -1
- package/dist/plugins/elizaos.js +0 -89
- package/dist/plugins/elizaos.js.map +0 -1
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module tokens/registry
|
|
3
|
+
* TokenRegistry — multi-chain token address registry for AgentWallet v6.
|
|
4
|
+
*
|
|
5
|
+
* Ships pre-populated with top tokens for all 11 supported EVM chains.
|
|
6
|
+
* All addresses sourced from:
|
|
7
|
+
* - EVM: CoinGecko official token lists + chain explorers
|
|
8
|
+
* - USDC: https://developers.circle.com/stablecoins/usdc-contract-addresses
|
|
9
|
+
* - WBTC: https://wbtc.network/dashboard/order
|
|
10
|
+
* - WETH: official wrapped ETH contracts per chain
|
|
11
|
+
* - L2 native tokens: official L2 documentation
|
|
12
|
+
*
|
|
13
|
+
* Chain IDs follow the CHAIN_IDS map in src/types.ts.
|
|
14
|
+
*/
|
|
15
|
+
import { zeroAddress } from 'viem';
|
|
16
|
+
// ─── Chain IDs ───────────────────────────────────────────────────────────────
|
|
17
|
+
const CHAIN = {
|
|
18
|
+
ETHEREUM: 1,
|
|
19
|
+
BASE: 8453,
|
|
20
|
+
ARBITRUM: 42161,
|
|
21
|
+
OPTIMISM: 10,
|
|
22
|
+
POLYGON: 137,
|
|
23
|
+
AVALANCHE: 43114,
|
|
24
|
+
UNICHAIN: 130,
|
|
25
|
+
LINEA: 59144,
|
|
26
|
+
SONIC: 146,
|
|
27
|
+
WORLDCHAIN: 480,
|
|
28
|
+
BASE_SEPOLIA: 84532,
|
|
29
|
+
};
|
|
30
|
+
// ─── Pre-verified token address tables ───────────────────────────────────────
|
|
31
|
+
//
|
|
32
|
+
// All addresses are verified against:
|
|
33
|
+
// - Etherscan (chain 1), Basescan (8453), Arbiscan (42161), Optimistic Etherscan (10),
|
|
34
|
+
// Polygonscan (137), Snowtrace (43114), Lineascan (59144)
|
|
35
|
+
// - CoinGecko token detail pages
|
|
36
|
+
// - Circle USDC registry
|
|
37
|
+
//
|
|
38
|
+
// NATIVE_ADDR = zeroAddress (0x0000...0000) — used for native gas tokens
|
|
39
|
+
const NATIVE_ADDR = zeroAddress;
|
|
40
|
+
// ─── Native gas tokens ────────────────────────────────────────────────────────
|
|
41
|
+
const NATIVE_TOKENS = [
|
|
42
|
+
// ETH on ETH-compatible chains
|
|
43
|
+
{ chainId: CHAIN.ETHEREUM, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
44
|
+
{ chainId: CHAIN.BASE, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
45
|
+
{ chainId: CHAIN.ARBITRUM, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
46
|
+
{ chainId: CHAIN.OPTIMISM, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
47
|
+
{ chainId: CHAIN.UNICHAIN, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
48
|
+
{ chainId: CHAIN.LINEA, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
49
|
+
{ chainId: CHAIN.WORLDCHAIN, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
50
|
+
{ chainId: CHAIN.BASE_SEPOLIA, address: NATIVE_ADDR, symbol: 'ETH', name: 'Ether', decimals: 18, isNative: true },
|
|
51
|
+
// MATIC on Polygon
|
|
52
|
+
{ chainId: CHAIN.POLYGON, address: NATIVE_ADDR, symbol: 'POL', name: 'POL (ex-MATIC)', decimals: 18, isNative: true },
|
|
53
|
+
// AVAX on Avalanche
|
|
54
|
+
{ chainId: CHAIN.AVALANCHE, address: NATIVE_ADDR, symbol: 'AVAX', name: 'Avalanche', decimals: 18, isNative: true },
|
|
55
|
+
// S (Sonic's native token)
|
|
56
|
+
{ chainId: CHAIN.SONIC, address: NATIVE_ADDR, symbol: 'S', name: 'Sonic', decimals: 18, isNative: true },
|
|
57
|
+
];
|
|
58
|
+
const EVM_TOKENS = [
|
|
59
|
+
// ─── Ethereum Mainnet (1) ────────────────────────────────────────────────
|
|
60
|
+
// USDC — Circle official
|
|
61
|
+
[CHAIN.ETHEREUM, '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', 'USDC', 'USD Coin', 6],
|
|
62
|
+
// USDT — Tether official
|
|
63
|
+
[CHAIN.ETHEREUM, '0xdAC17F958D2ee523a2206206994597C13D831ec7', 'USDT', 'Tether USD', 6],
|
|
64
|
+
// DAI — MakerDAO
|
|
65
|
+
[CHAIN.ETHEREUM, '0x6B175474E89094C44Da98b954EedeAC495271d0F', 'DAI', 'Dai Stablecoin', 18],
|
|
66
|
+
// WETH — official WETH9
|
|
67
|
+
[CHAIN.ETHEREUM, '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', 'WETH', 'Wrapped Ether', 18],
|
|
68
|
+
// WBTC — BitGo wrapped BTC
|
|
69
|
+
[CHAIN.ETHEREUM, '0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599', 'WBTC', 'Wrapped BTC', 8],
|
|
70
|
+
// LINK — Chainlink
|
|
71
|
+
[CHAIN.ETHEREUM, '0x514910771AF9Ca656af840dff83E8264EcF986CA', 'LINK', 'ChainLink Token', 18],
|
|
72
|
+
// UNI — Uniswap
|
|
73
|
+
[CHAIN.ETHEREUM, '0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984', 'UNI', 'Uniswap', 18],
|
|
74
|
+
// AAVE
|
|
75
|
+
[CHAIN.ETHEREUM, '0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9', 'AAVE', 'Aave Token', 18],
|
|
76
|
+
// CRV — Curve DAO Token
|
|
77
|
+
[CHAIN.ETHEREUM, '0xD533a949740bb3306d119CC777fa900bA034cd52', 'CRV', 'Curve DAO Token', 18],
|
|
78
|
+
// MKR — MakerDAO
|
|
79
|
+
[CHAIN.ETHEREUM, '0x9f8F72aA9304c8B593d555F12eF6589cC3A579A2', 'MKR', 'Maker', 18],
|
|
80
|
+
// SNX — Synthetix
|
|
81
|
+
[CHAIN.ETHEREUM, '0xC011a73ee8576Fb46F5E1c5751cA3B9Fe0af2a6F', 'SNX', 'Synthetix Network Token', 18],
|
|
82
|
+
// COMP — Compound
|
|
83
|
+
[CHAIN.ETHEREUM, '0xc00e94Cb662C3520282E6f5717214004A7f26888', 'COMP', 'Compound', 18],
|
|
84
|
+
// LDO — Lido DAO
|
|
85
|
+
[CHAIN.ETHEREUM, '0x5A98FcBEA516Cf06857215779Fd812CA3beF1B32', 'LDO', 'Lido DAO Token', 18],
|
|
86
|
+
// MATIC (ERC-20 on ETH, now POL)
|
|
87
|
+
[CHAIN.ETHEREUM, '0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0', 'POL', 'POL (ex-MATIC)', 18],
|
|
88
|
+
// ─── Base Mainnet (8453) ─────────────────────────────────────────────────
|
|
89
|
+
[CHAIN.BASE, '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', 'USDC', 'USD Coin', 6],
|
|
90
|
+
[CHAIN.BASE, '0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2', 'USDT', 'Tether USD', 6],
|
|
91
|
+
[CHAIN.BASE, '0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb', 'DAI', 'Dai Stablecoin', 18],
|
|
92
|
+
[CHAIN.BASE, '0x4200000000000000000000000000000000000006', 'WETH', 'Wrapped Ether', 18],
|
|
93
|
+
// WBTC on Base — bridged via LayerZero
|
|
94
|
+
[CHAIN.BASE, '0x0555E30da8f98308EdB960aa94C0Db47230d2B9c', 'WBTC', 'Wrapped BTC', 8],
|
|
95
|
+
[CHAIN.BASE, '0xE3B53AF74a4BF62Ae5511055290838050bf764Df', 'LINK', 'ChainLink Token', 18],
|
|
96
|
+
[CHAIN.BASE, '0xc3De830EA07524a0761646a6a4e4be0e114a3C83', 'AAVE', 'Aave Token', 18],
|
|
97
|
+
// cbETH — Coinbase Staked ETH
|
|
98
|
+
[CHAIN.BASE, '0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22', 'cbETH', 'Coinbase Staked Ether', 18],
|
|
99
|
+
// USDbC — Bridged USDC (legacy on Base)
|
|
100
|
+
[CHAIN.BASE, '0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA', 'USDbC', 'USD Base Coin', 6],
|
|
101
|
+
// ─── Arbitrum One (42161) ────────────────────────────────────────────────
|
|
102
|
+
[CHAIN.ARBITRUM, '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', 'USDC', 'USD Coin', 6],
|
|
103
|
+
[CHAIN.ARBITRUM, '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9', 'USDT', 'Tether USD', 6],
|
|
104
|
+
[CHAIN.ARBITRUM, '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1', 'DAI', 'Dai Stablecoin', 18],
|
|
105
|
+
[CHAIN.ARBITRUM, '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1', 'WETH', 'Wrapped Ether', 18],
|
|
106
|
+
[CHAIN.ARBITRUM, '0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f', 'WBTC', 'Wrapped BTC', 8],
|
|
107
|
+
[CHAIN.ARBITRUM, '0xf97f4df75117a78c1A5a0DBb814Af92458539FB4', 'LINK', 'ChainLink Token', 18],
|
|
108
|
+
[CHAIN.ARBITRUM, '0xFa7F8980b0f1E64A2062791cc3b0871572f1F7f0', 'UNI', 'Uniswap', 18],
|
|
109
|
+
[CHAIN.ARBITRUM, '0xba5DdD1f9d7F570dc94a51479a000E3BCE967196', 'AAVE', 'Aave Token', 18],
|
|
110
|
+
// ARB — Arbitrum governance token (native to Arbitrum)
|
|
111
|
+
[CHAIN.ARBITRUM, '0x912CE59144191C1204E64559FE8253a0e49E6548', 'ARB', 'Arbitrum', 18],
|
|
112
|
+
[CHAIN.ARBITRUM, '0x11cDb42B0EB46D95f990BeDD4695A6e3fA034978', 'CRV', 'Curve DAO Token', 18],
|
|
113
|
+
[CHAIN.ARBITRUM, '0x13Ad51ed4F1B7e9Dc168d8a00cB3f4dDD85EfA60', 'LDO', 'Lido DAO Token', 18],
|
|
114
|
+
[CHAIN.ARBITRUM, '0x354A6dA3fcde098F8389cad84b0182725c6C91dE', 'COMP', 'Compound', 18],
|
|
115
|
+
// ─── Optimism (10) ───────────────────────────────────────────────────────
|
|
116
|
+
[CHAIN.OPTIMISM, '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', 'USDC', 'USD Coin', 6],
|
|
117
|
+
[CHAIN.OPTIMISM, '0x94b008aA00579c1307B0EF2c499aD98a8ce58e58', 'USDT', 'Tether USD', 6],
|
|
118
|
+
[CHAIN.OPTIMISM, '0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1', 'DAI', 'Dai Stablecoin', 18],
|
|
119
|
+
[CHAIN.OPTIMISM, '0x4200000000000000000000000000000000000006', 'WETH', 'Wrapped Ether', 18],
|
|
120
|
+
[CHAIN.OPTIMISM, '0x68f180fcCe6836688e9084f035309E29Bf0A2095', 'WBTC', 'Wrapped BTC', 8],
|
|
121
|
+
[CHAIN.OPTIMISM, '0x350a791Bfc2C21F9Ed5d10980Dad2e2638ffa7f6', 'LINK', 'ChainLink Token', 18],
|
|
122
|
+
[CHAIN.OPTIMISM, '0x6fd9d7AD17242c41f7131d257212c54A0e816691', 'UNI', 'Uniswap', 18],
|
|
123
|
+
[CHAIN.OPTIMISM, '0x76FB31fb4af56892A25e32cFC43De717950c9278', 'AAVE', 'Aave Token', 18],
|
|
124
|
+
// OP — Optimism governance token (native to Optimism)
|
|
125
|
+
[CHAIN.OPTIMISM, '0x4200000000000000000000000000000000000042', 'OP', 'Optimism', 18],
|
|
126
|
+
[CHAIN.OPTIMISM, '0x9560e827aF36c94D2Ac33a39bCE1Fe78631088Db', 'VELO', 'Velodrome Finance', 18],
|
|
127
|
+
[CHAIN.OPTIMISM, '0xc5b001DC33727F8F26880B184090D3E252470D45', 'SNX', 'Synthetix', 18],
|
|
128
|
+
// ─── Polygon (137) ───────────────────────────────────────────────────────
|
|
129
|
+
[CHAIN.POLYGON, '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359', 'USDC', 'USD Coin', 6],
|
|
130
|
+
[CHAIN.POLYGON, '0xc2132D05D31c914a87C6611C10748AEb04B58e8F', 'USDT', 'Tether USD', 6],
|
|
131
|
+
[CHAIN.POLYGON, '0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063', 'DAI', 'Dai Stablecoin', 18],
|
|
132
|
+
[CHAIN.POLYGON, '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619', 'WETH', 'Wrapped Ether', 18],
|
|
133
|
+
[CHAIN.POLYGON, '0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6', 'WBTC', 'Wrapped BTC', 8],
|
|
134
|
+
[CHAIN.POLYGON, '0x53E0bca35eC356BD5ddDFebbD1Fc0fD03FaBad39', 'LINK', 'ChainLink Token', 18],
|
|
135
|
+
[CHAIN.POLYGON, '0xb33EaAd8d922B1083446DC23f610c2567fB5180f', 'UNI', 'Uniswap', 18],
|
|
136
|
+
[CHAIN.POLYGON, '0xD6DF932A45C0f255f85145f286eA0b292B21C90B', 'AAVE', 'Aave Token', 18],
|
|
137
|
+
// WMATIC — Wrapped POL (MATIC) on Polygon
|
|
138
|
+
[CHAIN.POLYGON, '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270', 'WMATIC', 'Wrapped POL (MATIC)', 18],
|
|
139
|
+
[CHAIN.POLYGON, '0x172370d5Cd63279eFa6d502DAB29171933a610AF', 'CRV', 'Curve DAO Token', 18],
|
|
140
|
+
[CHAIN.POLYGON, '0x50B728D8D964fd00C2d0AAD81718b71311feF68a', 'SNX', 'Synthetix', 18],
|
|
141
|
+
// ─── Avalanche C-Chain (43114) ───────────────────────────────────────────
|
|
142
|
+
[CHAIN.AVALANCHE, '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E', 'USDC', 'USD Coin', 6],
|
|
143
|
+
[CHAIN.AVALANCHE, '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7', 'USDT', 'Tether USD', 6],
|
|
144
|
+
[CHAIN.AVALANCHE, '0xd586E7F844cEa2F87f50152665BCbc2C279D8d70', 'DAI', 'Dai Stablecoin', 18],
|
|
145
|
+
// WETH.e — Bridged Ether on Avalanche
|
|
146
|
+
[CHAIN.AVALANCHE, '0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB', 'WETH.e', 'Wrapped Ether', 18],
|
|
147
|
+
[CHAIN.AVALANCHE, '0x50b7545627a5162F82A992c33b87aDc75187B218', 'WBTC', 'Wrapped BTC', 8],
|
|
148
|
+
[CHAIN.AVALANCHE, '0x5947BB275c521040051D82396192181b413227A3', 'LINK', 'ChainLink Token', 18],
|
|
149
|
+
[CHAIN.AVALANCHE, '0x8eBAf22B6F053dFFeaf46f4Dd9eFA95D89ba8580', 'UNI', 'Uniswap', 18],
|
|
150
|
+
// WAVAX — Wrapped AVAX
|
|
151
|
+
[CHAIN.AVALANCHE, '0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7', 'WAVAX', 'Wrapped AVAX', 18],
|
|
152
|
+
[CHAIN.AVALANCHE, '0x63a72806098Bd3D9520cC43356dD78afe5D386D9', 'AAVE', 'Aave Token', 18],
|
|
153
|
+
// ─── Unichain (130) ──────────────────────────────────────────────────────
|
|
154
|
+
[CHAIN.UNICHAIN, '0x078D782b760474a361dDA0AF3839290b0EF57AD6', 'USDC', 'USD Coin', 6],
|
|
155
|
+
[CHAIN.UNICHAIN, '0x4200000000000000000000000000000000000006', 'WETH', 'Wrapped Ether', 18],
|
|
156
|
+
// ─── Linea (59144) ───────────────────────────────────────────────────────
|
|
157
|
+
[CHAIN.LINEA, '0x176211869cA2b568f2A7D4EE941E073a821EE1ff', 'USDC', 'USD Coin', 6],
|
|
158
|
+
[CHAIN.LINEA, '0xA219439258ca9da29E9Cc4cE5596924745e12B93', 'USDT', 'Tether USD', 6],
|
|
159
|
+
[CHAIN.LINEA, '0x4AF15ec2A0BD43Db75dd04E62FAA3B8EF36b00d5', 'DAI', 'Dai Stablecoin', 18],
|
|
160
|
+
[CHAIN.LINEA, '0xe5D7C2a44FfDDf6b295A15c148167daaAf5Cf34f', 'WETH', 'Wrapped Ether', 18],
|
|
161
|
+
[CHAIN.LINEA, '0x3aAB2285ddcDdaD8edf438C1bAB47e1a9D05a9b4', 'WBTC', 'Wrapped BTC', 8],
|
|
162
|
+
// ─── Sonic (146) ─────────────────────────────────────────────────────────
|
|
163
|
+
[CHAIN.SONIC, '0x29219dd400f2Bf60E5a23d13Be72B486D4038894', 'USDC', 'USD Coin', 6],
|
|
164
|
+
// WS — Wrapped Sonic (native S wrapped)
|
|
165
|
+
[CHAIN.SONIC, '0x039e2fB66102314Ce7b64Ce5Ce3E5183bc94aD38', 'WS', 'Wrapped Sonic', 18],
|
|
166
|
+
// ─── World Chain (480) ───────────────────────────────────────────────────
|
|
167
|
+
[CHAIN.WORLDCHAIN, '0x79A02482A880bCE3B13e09Da970dC34db4CD24d1', 'USDC', 'USD Coin', 6],
|
|
168
|
+
[CHAIN.WORLDCHAIN, '0x4200000000000000000000000000000000000006', 'WETH', 'Wrapped Ether', 18],
|
|
169
|
+
// WLD — Worldcoin token
|
|
170
|
+
[CHAIN.WORLDCHAIN, '0x163f8C2467924be0ae7B5347228CABF260318753', 'WLD', 'Worldcoin', 18],
|
|
171
|
+
// ─── Base Sepolia Testnet (84532) ────────────────────────────────────────
|
|
172
|
+
[CHAIN.BASE_SEPOLIA, '0x036CbD53842c5426634e7929541eC2318f3dCF7e', 'USDC', 'USD Coin', 6],
|
|
173
|
+
[CHAIN.BASE_SEPOLIA, '0x4200000000000000000000000000000000000006', 'WETH', 'Wrapped Ether', 18],
|
|
174
|
+
];
|
|
175
|
+
// ─── TokenRegistry class ──────────────────────────────────────────────────────
|
|
176
|
+
export class TokenRegistry {
|
|
177
|
+
constructor(initialTokens) {
|
|
178
|
+
this.tokens = new Map();
|
|
179
|
+
// Load native gas tokens
|
|
180
|
+
for (const t of NATIVE_TOKENS) {
|
|
181
|
+
this._store(t);
|
|
182
|
+
}
|
|
183
|
+
// Load EVM tokens
|
|
184
|
+
for (const [chainId, address, symbol, name, decimals] of EVM_TOKENS) {
|
|
185
|
+
this._store({ chainId, address, symbol, name, decimals });
|
|
186
|
+
}
|
|
187
|
+
// Load any provided custom tokens
|
|
188
|
+
if (initialTokens) {
|
|
189
|
+
for (const t of initialTokens) {
|
|
190
|
+
this._store(t);
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
_key(symbol, chainId) {
|
|
195
|
+
return `${symbol.toUpperCase()}:${chainId}`;
|
|
196
|
+
}
|
|
197
|
+
_store(entry) {
|
|
198
|
+
const key = this._key(entry.symbol, entry.chainId);
|
|
199
|
+
this.tokens.set(key, { ...entry });
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* Add or overwrite a token in the registry.
|
|
203
|
+
*/
|
|
204
|
+
addToken(params) {
|
|
205
|
+
const entry = {
|
|
206
|
+
symbol: params.symbol,
|
|
207
|
+
address: params.address,
|
|
208
|
+
decimals: params.decimals,
|
|
209
|
+
chainId: params.chainId,
|
|
210
|
+
name: params.name ?? params.symbol,
|
|
211
|
+
isNative: params.isNative ?? false,
|
|
212
|
+
};
|
|
213
|
+
this._store(entry);
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* Look up a token by symbol and chainId.
|
|
217
|
+
* Returns undefined if not found.
|
|
218
|
+
*/
|
|
219
|
+
getToken(symbol, chainId) {
|
|
220
|
+
return this.tokens.get(this._key(symbol, chainId));
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* List all tokens registered for a given chainId.
|
|
224
|
+
*/
|
|
225
|
+
listTokens(chainId) {
|
|
226
|
+
const result = [];
|
|
227
|
+
for (const entry of this.tokens.values()) {
|
|
228
|
+
if (entry.chainId === chainId)
|
|
229
|
+
result.push(entry);
|
|
230
|
+
}
|
|
231
|
+
return result;
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* Find a token by its contract address on a given chain.
|
|
235
|
+
*/
|
|
236
|
+
getTokenByAddress(address, chainId) {
|
|
237
|
+
const lower = address.toLowerCase();
|
|
238
|
+
for (const entry of this.tokens.values()) {
|
|
239
|
+
if (entry.chainId === chainId && entry.address.toLowerCase() === lower) {
|
|
240
|
+
return entry;
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
return undefined;
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
* Returns all registered tokens (all chains).
|
|
247
|
+
*/
|
|
248
|
+
getAllTokens() {
|
|
249
|
+
return Array.from(this.tokens.values());
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* Returns number of registered tokens.
|
|
253
|
+
*/
|
|
254
|
+
size() {
|
|
255
|
+
return this.tokens.size;
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
// ─── Pre-built per-chain registries ──────────────────────────────────────────
|
|
259
|
+
// These are lazy singletons — constructed once on first import.
|
|
260
|
+
let _globalRegistry = null;
|
|
261
|
+
/** Global registry with all supported chains pre-populated. */
|
|
262
|
+
export function getGlobalRegistry() {
|
|
263
|
+
if (!_globalRegistry)
|
|
264
|
+
_globalRegistry = new TokenRegistry();
|
|
265
|
+
return _globalRegistry;
|
|
266
|
+
}
|
|
267
|
+
/** Create a fresh registry pre-populated for a single chain.
|
|
268
|
+
* @internal — reserved for future per-chain filtering API
|
|
269
|
+
*/
|
|
270
|
+
export function createChainRegistry(_chainId) {
|
|
271
|
+
return new TokenRegistry(); // loads all tokens; filter via listTokens(chainId)
|
|
272
|
+
}
|
|
273
|
+
// Named per-chain exports — each returns the global registry (all tokens loaded,
|
|
274
|
+
// filtered access via listTokens(chainId)). Use getGlobalRegistry() for multi-chain.
|
|
275
|
+
export const ETHEREUM_REGISTRY = new TokenRegistry();
|
|
276
|
+
export const BASE_REGISTRY = new TokenRegistry();
|
|
277
|
+
export const ARBITRUM_REGISTRY = new TokenRegistry();
|
|
278
|
+
export const OPTIMISM_REGISTRY = new TokenRegistry();
|
|
279
|
+
export const POLYGON_REGISTRY = new TokenRegistry();
|
|
280
|
+
export const AVALANCHE_REGISTRY = new TokenRegistry();
|
|
281
|
+
export const UNICHAIN_REGISTRY = new TokenRegistry();
|
|
282
|
+
export const LINEA_REGISTRY = new TokenRegistry();
|
|
283
|
+
export const SONIC_REGISTRY = new TokenRegistry();
|
|
284
|
+
export const WORLDCHAIN_REGISTRY = new TokenRegistry();
|
|
285
|
+
export const BASE_SEPOLIA_REGISTRY = new TokenRegistry();
|
|
286
|
+
// Convenience: get native gas token for a chain
|
|
287
|
+
export function getNativeToken(chainId) {
|
|
288
|
+
return getGlobalRegistry().getToken('ETH', chainId)
|
|
289
|
+
?? getGlobalRegistry().getToken('POL', chainId)
|
|
290
|
+
?? getGlobalRegistry().getToken('AVAX', chainId)
|
|
291
|
+
?? getGlobalRegistry().getToken('S', chainId);
|
|
292
|
+
}
|
|
293
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tokens/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module tokens/solana
|
|
3
|
+
* Solana SPL token support for AgentWallet v6.
|
|
4
|
+
*
|
|
5
|
+
* Uses @solana/web3.js as an optional peer dependency.
|
|
6
|
+
* All imports are done dynamically so EVM-only users pay zero overhead.
|
|
7
|
+
*
|
|
8
|
+
* Token addresses verified against:
|
|
9
|
+
* - Solana SPL Token Registry: https://raw.githubusercontent.com/solana-labs/token-list/main/src/tokens/solana.tokenlist.json
|
|
10
|
+
* - USDC on Solana: https://developers.circle.com/stablecoins/usdc-contract-addresses
|
|
11
|
+
* - Raydium: https://docs.raydium.io/raydium/token-pairs-and-liquidity
|
|
12
|
+
*/
|
|
13
|
+
export declare const SOLANA_TOKENS: {
|
|
14
|
+
readonly SOL: null;
|
|
15
|
+
readonly USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
|
|
16
|
+
readonly USDT: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
|
|
17
|
+
readonly RAY: "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R";
|
|
18
|
+
readonly SRM: "SRMuApVNdxXokk5GT7XD5cUUgXMBCoAz2LHeuAoKWRt";
|
|
19
|
+
readonly BONK: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";
|
|
20
|
+
readonly JITOSOL: "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn";
|
|
21
|
+
readonly MSOL: "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So";
|
|
22
|
+
readonly WBTC: "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh";
|
|
23
|
+
readonly WETH: "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs";
|
|
24
|
+
};
|
|
25
|
+
export type SolanaTokenSymbol = keyof typeof SOLANA_TOKENS;
|
|
26
|
+
export interface SolanaTokenInfo {
|
|
27
|
+
symbol: SolanaTokenSymbol;
|
|
28
|
+
mint: string | null;
|
|
29
|
+
decimals: number;
|
|
30
|
+
name: string;
|
|
31
|
+
}
|
|
32
|
+
/** Known decimals for Solana tokens */
|
|
33
|
+
export declare const SOLANA_TOKEN_DECIMALS: Record<SolanaTokenSymbol, number>;
|
|
34
|
+
export interface SolanaWalletConfig {
|
|
35
|
+
/** Solana RPC endpoint (default: mainnet) */
|
|
36
|
+
rpcUrl?: string;
|
|
37
|
+
/** Base-58 encoded private key for the signer */
|
|
38
|
+
privateKeyBase58?: string;
|
|
39
|
+
/** Keypair bytes (Uint8Array of 64 bytes) */
|
|
40
|
+
keypairBytes?: Uint8Array;
|
|
41
|
+
}
|
|
42
|
+
export interface SolBalanceResult {
|
|
43
|
+
rawBalance: bigint;
|
|
44
|
+
sol: string;
|
|
45
|
+
}
|
|
46
|
+
export interface SplBalanceResult {
|
|
47
|
+
mint: string;
|
|
48
|
+
rawBalance: bigint;
|
|
49
|
+
humanBalance: string;
|
|
50
|
+
decimals: number;
|
|
51
|
+
}
|
|
52
|
+
export interface SolanaTxResult {
|
|
53
|
+
signature: string;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Solana wallet for native SOL and SPL token operations.
|
|
57
|
+
* Uses @solana/web3.js (optional peer dependency, dynamically imported).
|
|
58
|
+
*/
|
|
59
|
+
export declare class SolanaWallet {
|
|
60
|
+
private readonly rpcUrl;
|
|
61
|
+
private readonly config;
|
|
62
|
+
private _connection;
|
|
63
|
+
private _keypair;
|
|
64
|
+
constructor(config?: SolanaWalletConfig);
|
|
65
|
+
private getConnection;
|
|
66
|
+
private getKeypair;
|
|
67
|
+
/** Get signer's public key as base-58 string */
|
|
68
|
+
getPublicKey(): Promise<string>;
|
|
69
|
+
/**
|
|
70
|
+
* Get native SOL balance.
|
|
71
|
+
* @param address - Optional base-58 public key to check (defaults to wallet's key)
|
|
72
|
+
*/
|
|
73
|
+
getSolBalance(address?: string): Promise<SolBalanceResult>;
|
|
74
|
+
/**
|
|
75
|
+
* Get SPL token balance for a given mint.
|
|
76
|
+
* @param mintAddress - SPL token mint address (base-58)
|
|
77
|
+
* @param owner - Optional owner address (defaults to wallet's key)
|
|
78
|
+
*/
|
|
79
|
+
getSplTokenBalance(mintAddress: string, owner?: string): Promise<SplBalanceResult>;
|
|
80
|
+
/**
|
|
81
|
+
* Send native SOL to a recipient.
|
|
82
|
+
* @param to - Recipient base-58 public key
|
|
83
|
+
* @param amount - Lamports (bigint) OR SOL amount as string (e.g. "1.5")
|
|
84
|
+
*/
|
|
85
|
+
sendSol(to: string, amount: string | bigint): Promise<SolanaTxResult>;
|
|
86
|
+
/**
|
|
87
|
+
* Send SPL tokens to a recipient.
|
|
88
|
+
* Creates the recipient's associated token account if it doesn't exist.
|
|
89
|
+
*
|
|
90
|
+
* @param to - Recipient base-58 public key
|
|
91
|
+
* @param amount - Raw token units (bigint) OR human-readable string
|
|
92
|
+
* @param mintAddress - SPL token mint address (base-58)
|
|
93
|
+
*/
|
|
94
|
+
sendSplToken(to: string, amount: string | bigint, mintAddress: string): Promise<SolanaTxResult>;
|
|
95
|
+
/**
|
|
96
|
+
* List all SPL token accounts for the wallet.
|
|
97
|
+
*/
|
|
98
|
+
listSplTokenAccounts(): Promise<Array<{
|
|
99
|
+
mint: string;
|
|
100
|
+
amount: bigint;
|
|
101
|
+
decimals: number;
|
|
102
|
+
}>>;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Create a SolanaWallet instance.
|
|
106
|
+
*/
|
|
107
|
+
export declare function createSolanaWallet(config: SolanaWalletConfig): SolanaWallet;
|
|
108
|
+
//# sourceMappingURL=solana.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/tokens/solana.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,eAAO,MAAM,aAAa;;;;;;;;;;;CA8BhB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAWnE,CAAC;AA4DF,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAG5C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAa;gBAEjB,MAAM,GAAE,kBAAuB;YAK7B,aAAa;YAOb,UAAU;IAwBxB,gDAAgD;IAC1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBhE;;;;OAIG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;;OAIG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6B3E;;;;;;;OAOG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;IA6D1B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmBjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}
|