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-ethers
```
ContractFactory
Verify
```
eth_getCode != 0x
```
after 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!

Abstract Onboard

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

Be Part of the 2,149+ Developer Community