扫码联系在线客服Abstract Onboard
Everything an AI agent needs to operate on Abstract (ZK Stack L2).
🚀 New Agent? Start Here
# Check if you're ready to operate
node scripts/quick-start.js check <your-wallet-address>
# Or get the full setup guide
node scripts/quick-start.js
Quick Start
Create Abstract Global Wallet (AGW)
AGW is a smart contract wallet that earns XP on Abstract. Essential for agents!
⚠️ CRITICAL: Understand the 3 layers first:
Private Key → EOA (signer) → AGW (smart contract wallet)
The correct funding flow:
1. Fund EOA with small ETH (for gas)
2. Create/deploy AGW (EOA pays gas for first tx)
3. Fund AGW with your main balance
4. Everything runs through AGW from now on
export WALLET_PRIVATE_KEY=0x...
node scripts/create-agw.js
Your EOA becomes the signer, AGW is a separate smart contract address.
⚠️ Version Warning: Different agw-client versions may compute different AGW addresses! Always pin your version. See references/agw.md for details.
Check Balances
node scripts/check-balances.js <wallet> all
Bridge ETH to Abstract
export WALLET_PRIVATE_KEY=0x...
node scripts/relay-bridge.js --from base --amount 0.01
Deploy a Contract
export WALLET_PRIVATE_KEY=0x...
node scripts/deploy-abstract.js ./artifacts/MyContract.json "constructor-arg"
Transfer Tokens
export WALLET_PRIVATE_KEY=0x...
node scripts/transfer.js --to 0x... --amount 0.01 # ETH
node scripts/transfer.js --to 0x... --amount 100 --token USDC # Token
Swap Tokens
export WALLET_PRIVATE_KEY=0x...
export DEX_ROUTER=0x... # Set DEX router address
node scripts/swap-tokens.js --from ETH --to USDC --amount 0.01
DEX Trading (Kona & Aborean)
Abstract has multiple DEXs. Use the protocol-specific scripts for best results:
# Kona Finance (V2) - USDC → ETH
export WALLET_PRIVATE_KEY=0x...
node scripts/swap-kona.js
# Aborean (Velodrome-style) - when router is available
node scripts/swap-aborean.js
# Generic Uniswap V2
node scripts/swap-uniswap-v2.js
See references/dex.md for contract addresses and supported pools.
Myriad Prediction Markets
Trade on Myriad Markets — the largest prediction market on Abstract (415K+ users, $100M+ volume).
# List open markets
node scripts/myriad-trade.js list
# Get market details
node scripts/myriad-trade.js info <marketId>
# Buy shares (place a prediction)
export WALLET_PRIVATE_KEY=0x...
node scripts/myriad-buy-direct.js <marketId> <outcomeId> <amount>
# Example: $1 USDC.e on "Yes" for market 765
node scripts/myriad-buy-direct.js 765 0 1
See references/myriad.md for contract addresses, ABI details, and token info.
Call Any Contract
# Read
node scripts/call-contract.js --address 0x... --abi ./abi.json --function balanceOf --args 0x1234
# Write
export WALLET_PRIVATE_KEY=0x...
node scripts/call-contract.js --address 0x... --abi ./abi.json --function transfer --args 0x1234,100 --write
Mint NFT
# Deploy SimpleNFT.sol first, then mint
export WALLET_PRIVATE_KEY=0x...
# Mint to existing contract
node scripts/mint-nft.js --contract 0x... --image QmIPFShash --to 0xRecipient --name "My NFT"
See references/SimpleNFT.sol for a basic NFT contract template.
USDC Operations
# Check USDC balance
node scripts/usdc-ops.js balance <wallet>
# Transfer USDC
export WALLET_PRIVATE_KEY=0x...
node scripts/usdc-ops.js transfer <to> <amount>
# Approve spender
node scripts/usdc-ops.js approve <spender> <amount>
# Check allowance
node scripts/usdc-ops.js allowance <owner> <spender>
Estimate Gas
# Get current gas prices
node scripts/estimate-gas.js
# Estimate transfer cost
node scripts/estimate-gas.js transfer <to> <amount>
# Estimate deployment cost
node scripts/estimate-gas.js deploy <bytecodeSize>
Watch Events
# Watch new blocks
node scripts/watch-events.js blocks
# Watch ETH transfers to/from wallet
node scripts/watch-events.js transfers <wallet>
# Watch ERC20 transfers
node scripts/watch-events.js erc20 <token> <wallet>
# Watch contract events
node scripts/watch-events.js contract <address>
Testnet Setup
# Get faucet instructions
node scripts/testnet-setup.js faucet
# Check testnet balance
node scripts/testnet-setup.js check <wallet>
# Verify testnet setup
node scripts/testnet-setup.js verify <wallet>
Key Information
| Item | Value |
|------|-------|
| Chain ID | 2741 |
| RPC | https://api.mainnet.abs.xyz |
| Explorer | https://abscan.org |
| Bridge | https://relay.link/bridge/abstract |
| USDC | 0x84A71ccD554Cc1b02749b35d22F684CC8ec987e1 |
| WETH | 0x3439153EB7AF838Ad19d56E1571FBD09333C2809 |
| Kona Router | 0x441E0627Db5173Da098De86b734d136b27925250 |
| Uniswap V2 Router | 0xad1eCa41E6F772bE3cb5A48A6141f9bcc1AF9F7c |
| Myriad PM Contract | 0x3e0F5F8F5Fb043aBFA475C0308417Bf72c463289 |
| Myriad PTS Token | 0x0b07cf011B6e2b7E0803b892d97f751659940F23 |
| Myriad API | https://api-v2.myriadprotocol.com |
Scripts
| Script | Purpose |
|--------|---------|
| quick-start.js | START HERE - Setup guide & health check |
| create-agw.js | Create Abstract Global Wallet (earns XP!) |
| check-balances.js | Check ETH and token balances |
| relay-bridge.js | Bridge ETH from other chains |
| bridge-usdc-relay.js | Bridge USDC via Relay API |
| deploy-abstract.js | Deploy contracts to Abstract (with verification!) |
| verify-contract.js | Verify contract has bytecode (SAFETY CHECK) |
| transfer.js | Send ETH or tokens |
| usdc-ops.js | USDC transfers, approvals, allowances |
| swap-tokens.js | Trade tokens via DEX (generic) |
| swap-kona.js | Swap on Kona Finance (V2) ✅ |
| swap-aborean.js | Swap on Aborean (Velodrome-style) |
| swap-uniswap-v2.js | Swap on Uniswap V2 |
| myriad-trade.js | List markets, get info (Myriad API) |
| myriad-buy-direct.js | Place predictions on Myriad (on-chain) ✅ |
| call-contract.js | Call any contract function |
| mint-nft.js | Mint NFTs to existing contract |
| estimate-gas.js | Estimate gas costs before transactions |
| watch-events.js | Monitor on-chain events in real-time |
| testnet-setup.js | Setup and verify testnet access |
References
| File | Contents |
|------|----------|
| agw.md | Abstract Global Wallet guide (XP, activation) |
| dex.md | DEX contracts & swap patterns (Kona, Aborean) |
| myriad.md | Myriad prediction market contracts, ABI & trading |
| hardhat.config.js | Working Hardhat config for Abstract |
| addresses.md | Key contract addresses |
| troubleshooting.md | Common errors and fixes |
| SimpleNFT.sol | Basic NFT contract template |
⚠️ CRITICAL: Contract Deployment
Abstract is a zkSync-based chain. Standard EVM deployment methods DON'T WORK.
What WORKS ✅
// Use zksync-ethers (NOT viem, NOT standard ethers)
const { ContractFactory } = require("zksync-ethers");
const factory = new ContractFactory(abi, bytecode, wallet);
const contract = await factory.deploy(args);
// ALWAYS verify bytecode after deploy
const code = await provider.getCode(address);
if (code === '0x') throw new Error("Deploy failed!");
What DOESN'T WORK ❌
// DON'T use viem's deployContract
await walletClient.deployContract({...}); // Returns success but NO BYTECODE
// DON'T use standard ethers ContractFactory
// DON'T trust transaction success alone
Deployment Checklist
- [ ] Compiled with zksolc (not standard solc)
- [ ] Using
zksync-ethersContractFactory - [ ] Verify
eth_getCode != 0xafter deploy - [ ] Test contract functions before sending tokens
Common Issues
- Gas estimation fails → Use Hardhat, not foundry-zksync
- Compiler errors → Use Solidity 0.8.x with zksolc
- TX stuck → Check gas price, verify on abscan.org
- Deploy succeeds but no bytecode → Use zksync-ethers, not viem
- Tokens sent to empty address → Always verify bytecode first!
See references/troubleshooting.md for detailed solutions.
Dependencies
# Core dependencies
npm install ethers zksync-ethers viem
# For contract deployment
npm install @matterlabs/hardhat-zksync
# For AGW (Abstract Global Wallet) - PIN THE VERSION!
# Different versions compute different AGW addresses
npm install @abstract-foundation/agw-client@1.10.0
⚠️ agw-client version warning: Newer versions may use different factory contracts, computing different AGW addresses for the same EOA. If you change versions, verify your AGW address hasn't changed before sending funds!