morph-skill

Morph Skill

Overview

An AI Agent skill for interacting with the Morph L2 blockchain, enabling natural-language-driven wallet operations, on-chain data queries, DEX swaps, cross-chain bridge swaps, EIP-7702 EOA delegation, and x402 HTTP payment protocol.

Role Boundary

This repository is the Morph protocol and business layer for AI agents. It owns Morph-native workflows such as:

• wallet RPC operations
• explorer queries
• DEX and bridge flows
• altfee gas payment
• EIP-8004 identity and reputation
• EIP-7702 EOA delegation and atomic batch calls
• x402 HTTP payment protocol (pay and receive USDC)

BGW should be treated as the separate wallet product and signing layer. BGW owns:

• Social Login Wallet (TEE-backed signing — private key never leaves Bitget's TEE)
• swap execution across chains including Morph (with TEE signing for Social Login Wallet users)
• token discovery, market data, and security audits

Note: Social Login Wallet onboarding (email/Google/Apple login) happens in the Bitget Wallet APP, not through skill commands. See docs/social-wallet-integration.md for setup details.

This repository does not implement BGW login, Social Login Wallet session handling, or BGW runtime integration. If an agent is expected to help with both Morph protocol actions and Social Login Wallet flows, it should load both the Morph skill pack and the BGW skill pack up front.

For the combined model, see docs/social-wallet-integration.md.

Core Capabilities

Capability	Description	Example
Wallet Create	Generate ETH key pair locally	"Create a new wallet"
Balance Query	Native ETH and ERC20 token balances	"How much ETH do I have?"
Token Transfer	Send ETH or ERC20 tokens	"Send 10 USDT to 0x..."
Transaction Lookup	Receipt and detailed tx info	"What happened in this tx?"
Address Info	On-chain address summary	"Show me this wallet's activity"
Transaction History	List transactions for an address	"Recent txs for 0x..."
Token Holdings	All token balances for an address	"What tokens does this wallet hold?"
Token Search	Find tokens by name or symbol	"Find the USDT contract address"
Contract Info	Contract source code, ABI, proxy info	"Is this contract verified?"
Agent Register	Register an ERC-8004 agent identity on Morph	"Register this agent with name and metadata"
Agent Wallet	Read an agent's payment wallet	"What's the wallet for agent 12?"
Agent Metadata	Read agent metadata by key	"Get the name metadata for agent 12"
Agent Reputation	Aggregate on-chain reputation summary	"Show reputation for agent 12"
Agent Feedback	Submit EIP-8004 feedback for an agent	"Leave a 4.5 score for agent 12"
Agent Reviews	Read all recorded feedback entries	"Show all reviews for agent 12"
Agent Set Metadata	Set a metadata key-value pair for an agent	"Update the role metadata for agent 12"
Agent Set URI	Set or update the agent URI	"Update the URI for agent 12"
Agent Set Wallet	Bind an operational wallet to an agent	"Bind wallet 0x... to agent 12"
Agent Unset Wallet	Unbind the operational wallet from an agent	"Remove the wallet binding from agent 12"
Agent Revoke Feedback	Revoke previously submitted feedback	"Retract my review for agent 12"
Agent Append Response	Append an owner response to a feedback entry	"Reply to the feedback on agent 12"
Token Transfers	Recent transfer history for a token or address	"Show recent USDT transfers"
Token Info	Token details: supply, holders, transfers	"How many holders does USDT have?"
DEX Quote	Best-route swap quote + calldata (Morph only)	"How much USDT for 1 ETH?"
DEX Send	Sign and broadcast swap transaction (Morph only)	Complete the swap on-chain
DEX Approve	Approve ERC-20 spending by a DEX router	"Approve USDT for the router"
DEX Allowance	Check ERC-20 allowance for a spender	"How much USDT can the router spend?"
Bridge Quote	Cross-chain swap quote across 6 chains	"How much to bridge USDC from Base to Morph?"
Bridge Swap	One-step cross-chain swap: create, sign, and submit	"Bridge 10 USDT from Morph to Base"
Bridge Order	Track cross-chain swap order status	"Check my bridge order status"
Bridge Balance	Token balance + USD price on any supported chain	"What's my USDC balance on Base?"
Alt-Fee Tokens	List supported alt-fee tokens	"What tokens can I use to pay gas?"
Alt-Fee Token Info	Fee token details (scale, rate)	"Get info for fee token 5"
Alt-Fee Estimate	Estimate gas cost in alt token	"How much USDT to cover gas?"