Abstract 入门指南

AI 代理在 Abstract（ZK Stack L2）上运行所需的一切。

🚀 新代理？从这里开始

# 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

快速开始

创建 Abstract 全局钱包 (AGW)

AGW 是一个智能合约钱包，可在 Abstract 上赚取 XP。对代理至关重要！

⚠️ 关键：首先理解 3 个层级：

Private Key → EOA (signer) → AGW (smart contract wallet)

正确的资金流向：

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

您的 EOA 成为签名者，AGW 是一个独立的智能合约地址。

⚠️ 版本警告：不同agw-client版本可能计算出不同的 AGW 地址！请务必固定您的版本。详情请参阅references/agw.md。

检查余额

node scripts/check-balances.js <wallet> all

将 ETH 桥接到 Abstract

export WALLET_PRIVATE_KEY=0x...
node scripts/relay-bridge.js --from base --amount 0.01

部署合约

export WALLET_PRIVATE_KEY=0x...
node scripts/deploy-abstract.js ./artifacts/MyContract.json "constructor-arg"

转移代币

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

交换代币

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 交易（Kona & Aborean）

Abstract拥有多个去中心化交易所（DEX）。为实现最佳效果，请使用协议特定的脚本：

# 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

请参阅references/dex.md以获取合约地址和受支持的流动性池信息。

Myriad预测市场

在Myriad Markets上进行交易——这是Abstract上最大的预测市场（拥有超过41.5万用户，交易量超过1亿美元）。

# 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

请参阅references/myriad.md以获取合约地址、ABI详细信息和代币信息。

调用任意合约

# 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

铸造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"

请参阅references/SimpleNFT.sol以获取基础的NFT合约模板。

USDC操作

# 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>

估算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 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>

测试网设置

# 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>

关键信息

脚本

参考文献

⚠️ 重要：合约部署

Abstract是一条基于zkSync的链。标准的EVM部署方法**不适用**。

有效的方法 ✅

// 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!");

无效的方法 ❌

// 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

部署检查清单

• 使用 zksolc 编译（而非标准 solc）
• 使用zksync-ethersContractFactory
• 验证eth_getCode != 0x部署后
• 发送代币前测试合约功能

常见问题

1. Gas估算失败→ 使用Hardhat，而非foundry-zksync
2. 编译器错误→ 使用Solidity 0.8.x配合zksolc
3. 交易卡住→ 检查Gas价格，在abscan.org上验证
4. 部署成功但无字节码→ 使用zksync-ethers，而非viem
5. 代币发送至空地址→ 务必先验证字节码！

查看references/troubleshooting.md获取详细解决方案。

依赖项

# 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版本警告：新版本可能使用不同的工厂合约，为同一EOA计算出的AGW地址可能不同。更换版本后，发送资金前请确认您的AGW地址未发生变化！