Abstract Toolkit

Deploy smart contracts and bridge assets to Abstract (ZK Stack L2). Use when an agent needs to deploy contracts on Abstract, bridge ETH/tokens to Abstract, trade/swap tokens, check balances, transfer assets, or interact with Abstract mainnet. Covers zksolc compilation, Hardhat deployment, Relay bridging, DEX trading, and key contract addresses.

Security Scan

The skill's code and instructions largely match its stated purpose (deploying and bridging on Abstract), but it fails to declare required sensitive environment variables and installation steps — this mismatch is a meaningful coherence/privacy concern and you should review before use.

Purpose & Capability

Name/description match the included scripts: deployment, bridging, token transfer, swaps, AGW creation. The requested runtime behavior (signing transactions, calling RPCs, sending funds) is coherent with a blockchain toolkit. However the registry metadata declares no required env vars/credentials while the SKILL.md and scripts clearly require WALLET_PRIVATE_KEY (and optionally DEX_ROUTER), so the declared requirements do not match what the skill actually needs.

Instruction Scope

SKILL.md and scripts are explicit about actions to take: reading ABI/artifact files, using WALLET_PRIVATE_KEY to sign transactions, calling RPC endpoints, sending transactions to relay depositor and DEX router addresses. All file and network accesses are within the expected domain for on-chain operations (no unrelated filesystem or system-wide config reads).

Install Mechanism

This is instruction-only (no install spec) but includes multiple Node scripts that rely on npm packages (ethers, zksync-ethers, @abstract-foundation/agw-client, viem, Hardhat plugin). The SKILL.md lists the npm dependencies but does not provide an automated install step; users must run npm install themselves. No high-risk URL downloads or extract/install actions are present in the skill bundle.

Credentials

The scripts require WALLET_PRIVATE_KEY (sensitive) for any write/transfer/deploy operations and DEX_ROUTER is required for swaps, but the skill metadata declares no required environment variables or primary credential. Asking for a private key is legitimate for this functionality, but the omission from declared requirements and lack of guidance on secure handling increases the risk of accidental misuse or exposure.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide settings. It runs as invoked and relies on environment variables at runtime; autonomous invocation is allowed by default but not excessive here given the purpose.

What to consider before installing

Before installing or running this skill: - Treat WALLET_PRIVATE_KEY as highly sensitive. Do not set your main wallet private key in an environment variable for untrusted code. Prefer a throwaway/test account or hardware-wallet-backed signing. - The skill metadata does not declare required env vars (WALLET_PRIVATE_KEY, DEX_ROUTER). That mismatch is a red flag — expect to supply these to run write operations. - Inspect and, if necessary, pin the npm dependencies locally (ethers, zksync-ethers, @abstract-foundation/agw-client, viem, hardhat plugin). Run npm install in a controlled environment and review package versions. - Test all flows on Abstract testnet (chain ID 11124, test RPC) before using mainnet and bridge only small amounts first. - Verify critical addresses (Relay depositor, DEX router) independently from Abstract docs; the scripts will send on-chain funds to those addresses. - If you lack experience handling private keys securely, do not run the write operations; consider using a read-only mode (balance checks, non-write contract calls) or seek assistance. If you want higher assurance, ask the publisher for declared required env vars and an install script, or request the skill be updated so the registry metadata matches the actual runtime requirements.

Abstract Onboard

Everything an agent needs to operate on Abstract.

Quick Start

Create Abstract Global Wallet (AGW)

AGW is a smart contract wallet that earns XP on Abstract. Essential for agents!

export WALLET_PRIVATE_KEY=0x...
node scripts/create-agw.js

Your EOA becomes the signer, AGW is a separate smart contract address.

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

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

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

Scripts

Script	Purpose
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
deploy-abstract.js	Deploy contracts to Abstract
transfer.js	Send ETH or tokens
swap-tokens.js	Trade tokens via DEX
call-contract.js	Call any contract function

References

File	Contents
agw.md	Abstract Global Wallet guide (XP, activation)
hardhat.config.js	Working Hardhat config for Abstract
addresses.md	Key contract addresses
troubleshooting.md	Common errors and fixes

Common Issues

1. Gas estimation fails → Use Hardhat, not foundry-zksync
2. Compiler errors → Use Solidity 0.8.x with zksolc
3. TX stuck → Check gas price, verify on abscan.org

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)
npm install @abstract-foundation/agw-client