easctl

Command-line interface for the Ethereum Attestation Service. Built on the EAS SDK and ethers.

All commands support --json for structured output, --dry-run for gas estimation, and popular schema names (e.g. --schema make-a-statement) instead of raw UIDs.

Installation

npm install -g easctl

Or run directly with npx:

npx easctl --help

Configuration

Store your private key for persistent use:

easctl set-key 0xYourPrivateKeyHere

This saves the key to ~/.easctl (file permissions 0600, owner-only) and displays your wallet address for confirmation.

To remove the stored key:

easctl clear-key

Alternatively, set the EAS_PRIVATE_KEY environment variable. When set, it takes priority over the stored key:

export EAS_PRIVATE_KEY=0xYourPrivateKeyHere

Commands

Attestations

# Create an on-chain attestation
easctl attest \
  --schema 0xSchemaUID \
  --data '[{"name":"score","type":"uint256","value":"100"}]' \
  --recipient 0xRecipientAddress \
  --chain sepolia

# Create multiple attestations in one transaction
easctl multi-attest \
  --input '[{"schema":"0xSchemaUID","recipient":"0xAddr","data":[{"name":"score","type":"uint256","value":"100"}]}]' \
  --chain sepolia

# Create an off-chain (signed, not submitted) attestation
easctl offchain-attest \
  --schema 0xSchemaUID \
  --data '[{"name":"score","type":"uint256","value":"100"}]' \
  --recipient 0xRecipientAddress \
  --chain sepolia

# Revoke an attestation
easctl revoke --schema 0xSchemaUID --uid 0xAttestationUID --chain sepolia

# Revoke multiple attestations in one transaction
easctl multi-revoke \
  --input '[{"schema":"0xSchemaUID","uid":"0xUID1"},{"schema":"0xSchemaUID","uid":"0xUID2"}]' \
  --chain sepolia

# Get an attestation by UID (read-only, no key required)
easctl get-attestation --uid 0xAttestationUID --chain sepolia

# Auto-decode attestation data by fetching its schema from chain
easctl get-attestation --uid 0xAttestationUID --decode --chain sepolia

# Decode with an explicit schema string
easctl get-attestation --uid 0xAttestationUID --decode "uint256 score, string comment" --chain sepolia

Schemas

# Register a new schema
easctl schema-register --schema "uint256 score, string comment" --chain sepolia

# Get a schema by UID (read-only)
easctl schema-get --uid 0xSchemaUID --chain sepolia

# Browse popular schemas
easctl popular-schemas
easctl popular-schemas --category social
easctl popular-schemas --json

Popular Schema Names

Instead of raw UIDs, you can use popular schema names anywhere a schema UID is accepted:

easctl attest --schema make-a-statement --data '[{"name":"statement","type":"string","value":"Hello EAS"}]'
easctl query-attestations --schema is-a-friend --chain base

Run easctl popular-schemas to see all available names.

Timestamps

# Timestamp a single data item on-chain
easctl timestamp --data 0xBytes32Data --chain sepolia

# Timestamp multiple data items in one transaction
easctl multi-timestamp --data '["0xBytes32Data1","0xBytes32Data2"]' --chain sepolia

Queries

Query attestations and schemas from the EASScan indexer. Read-only, no private key required.

# Query a single attestation
easctl query-attestation --uid 0xAttestationUID --chain sepolia

# Query a single schema
easctl query-schema --uid 0xSchemaUID --chain sepolia

# Query attestations by schema or attester, with pagination
easctl query-attestations --schema 0xSchemaUID --limit 20 --skip 40 --chain sepolia
easctl query-attestations --attester 0xAddress --chain sepolia

# Query schemas by creator
easctl query-schemas --creator 0xAddress --limit 20 --chain sepolia

Utility

# Show wallet, chain, and contract configuration
easctl status
easctl status --chain base

# List supported chains
easctl chains

Options

Global

Option	Description
--json	Output results as JSON
--help	Display help for any command

Per command

Option	Description	Default
-c, --chain	Target chain	ethereum
--rpc-url	Custom RPC endpoint	Chain default
--dry-run	Estimate gas without sending (write commands)	-

Supported Chains

Ethereum, Sepolia, Base, Base Sepolia, Optimism, Optimism Sepolia, Arbitrum, Arbitrum Sepolia, Polygon, Scroll, Linea, Celo.

JSON Output

All commands return structured JSON when --json is passed:

{
  "success": true,
  "data": {
    "uid": "0x...",
    "txHash": "0x...",
    "attester": "0x...",
    "chain": "sepolia"
  }
}

On error:

{
  "success": false,
  "error": "Error message here"
}

Stdin Support

Commands that accept --data or --input can read from stdin by passing -:

cat attestation-data.json | easctl attest --schema 0x... --data - --chain sepolia
cat revocations.json | easctl multi-revoke --input - --chain sepolia

Development

npm install
npm run build
npm run test
node dist/index.js --help

License

MIT