Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts.

MITAuto-check: notesDevOps & Cloud

Install Genlayer CLI

skills CLI
$ npx skills add internet-court/internet-court-skill --skill genlayer-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install internet-court/internet-court-skill genlayer-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/internet-court/internet-court-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vendored/genlayer/genlayer-cli .claude/skills/genlayer-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
genlayer-cli
GitHub stars
6.4k
Used in
1 other repo
Token cost
~2.2k tokens
SKILL.md length
657 words
Files
3
Skills in repo
80
Repo updated
First seen
Licence
MIT

At a glance

Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts.

  • Works in 3 steps: Get your address: genlayer account ->… → Go to the faucet URL, paste the address,… → Verify: genlayer account should show the…
  • DevOps & Cloud work in your project
  • SKILL.md covers Setup, Network Configuration, Account Management and Funding Accounts, plus 8 more sections
  • Calls npm

What it does

Genlayer CLI is an agent skill from internet-court/internet-court-skill. Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `agents/openai.yaml`).

It sits in DevOps & Cloud. The repository describes itself as: The trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all… The licence is MIT.

When your agent uses it

  • DevOps & Cloud work in your project

Example prompts

  • “/genlayer-cli”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash, Read

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Get your address: genlayer account -> copy the address field
  2. Go to the faucet URL, paste the address, and claim 100 GEN (once per 24 hours)
  3. Verify: genlayer account should show the updated balance

What it can do on your machine

Read from SKILL.md and the folder at commit fa89195. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • testnet-faucet.genlayer.foundation

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Genlayer CLI loads about 2.2k tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 657 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from internet-court/internet-court-skill at commit fa89195, republished under its MIT licence (© internet-court). 657 words, ~2,156 tokens.

Download SKILL.mdSave it as .claude/skills/genlayer-cli/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
genlayer-cli
description
Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts.
allowed-tools
Bash, Read

GenLayer CLI

The genlayer CLI manages contract deployment, interaction, transaction inspection, and network configuration. Works with GenLayer Studio (local), studio.genlayer.com, and Testnet Bradbury.

Setup

bash
npm install -g genlayer

Network Configuration

bash
genlayer network set                    # Interactive selector
genlayer network set testnet-bradbury   # Direct
genlayer network info                   # Show current network config
genlayer network list                   # List all networks

Networks: localnet, studionet, testnet-asimov, testnet-bradbury

Note: studionet is gasless — no tokens are required to deploy or interact with contracts. A 0 GEN balance is expected and does not prevent any operations.

Note: studionet is rate-limited per IP — 60 req/min, 1000 req/hr, 10000 req/day. Limits aren't permanent — batching many deploy/write calls trips -32429 / HTTP 429 and further requests are rejected until the window resets (next minute / hour / day cycle). -32028 signals the pending-queue cap — up to 32 in-flight txs per sender; a separate cap also applies per contract. Throttle batch scripts, wait for receipts between submissions, or use localnet for heavy batches.

Always use genlayer network set instead of --rpc for built-in networks. The --rpc flag bypasses the chain configuration (consensus contract ABI, isStudio flag, etc.) and will cause transaction polling failures. Only use --rpc for custom/private networks not in the built-in list.

Account Management

bash
genlayer account                        # Show active account (address, balance, network)
genlayer account list                   # List all accounts
genlayer account create --name dev1     # Create new account
genlayer account use dev1               # Set active account
genlayer account unlock                 # Cache key in OS keychain (no password prompts)
genlayer account lock                   # Remove from keychain

# Import from private key or keystore
genlayer account import --name imported --private-key 0x...
genlayer account import --name imported --keystore ./keystore.json

# Send tokens
genlayer account send 0x123...abc 10gen

Amount formats: "10gen", "0.5gen", or raw wei "1000000000000000000"

Non-interactive usage (CI/CD, containers, agents)

account create, account import, and account send accept --password <password> to skip interactive prompts:

bash
genlayer account create --name dev1 --password "mypassword"
genlayer account import --name imported --private-key 0x... --password "mypassword"

account unlock requires an OS keychain (macOS Keychain, GNOME Keyring, etc.) and will fail in headless containers. When the account is locked, commands that sign transactions (deploy, write, appeal, account send) will prompt for the keystore password. To automate these, pipe the password via stdin:

bash
echo "mypassword" | genlayer deploy --contract contracts/my_contract.py --args "arg1"

Funding Accounts

New accounts start with 0 GEN. Funding requirements depend on the network:

StudioNet is gasless — accounts with 0 GEN can deploy and interact with contracts without any funding. A zero balance on StudioNet is expected and normal. Skip funding entirely when using StudioNet.

For testnets (Bradbury, Asimov), fund the account before deploying or writing.

Faucet: https://testnet-faucet.genlayer.foundation/

  1. Get your address: genlayer account -> copy the address field
  2. Go to the faucet URL, paste the address, and claim 100 GEN (once per 24 hours)
  3. Verify: genlayer account should show the updated balance

The faucet uses Cloudflare Turnstile and cannot be automated from CLI -- the user must claim manually in a browser. Works for both Testnet Bradbury and Testnet Asimov.

Contract Deployment

bash
# Deploy a specific contract
genlayer deploy --contract contracts/my_contract.py
genlayer deploy --contract contracts/my_contract.py --args "arg1" 42

# Run all deploy scripts in deploy/ folder
genlayer deploy

Contract Interaction

Read (no transaction)
bash
genlayer call <address> <method>
genlayer call 0x123...abc get_data --args "key1"
Write (sends transaction)
bash
genlayer write <address> <method>
genlayer write 0x123...abc set_data --args "hello"
Inspect contract
bash
genlayer schema <address>   # Method signatures and types
genlayer code <address>     # Source code

Transaction Debugging

The most useful debugging command — inspect what happened in a transaction:

bash
# Get full receipt (waits for FINALIZED by default)
genlayer receipt <txHash>

# Get just stdout or stderr from execution
genlayer receipt <txHash> --stdout
genlayer receipt <txHash> --stderr

# Wait for a lifecycle status
genlayer receipt <txHash> --status PENDING
genlayer receipt <txHash> --status ACCEPTED
genlayer receipt <txHash> --status FINALIZED

# Custom retry behavior
genlayer receipt <txHash> --retries 50 --interval 3000

Transaction lifecycle statuses: SUBMITTED -> PENDING -> ACCEPTED -> FINALIZED

Show full SKILL.md (262 more words)Show less
Lifecycle status is not execution success

ACCEPTED and FINALIZED mean the network accepted or finalized the transaction outcome. They do not mean the contract code executed successfully.

If contract execution fails, the transaction can still become ACCEPTED and later FINALIZED, but state changes are not applied. For deploy transactions, that means no contract is created. In that case, genlayer code, genlayer schema, eth_getCode, or gen_getContractSchema returning no contract is expected.

Always inspect the receipt execution result before diagnosing infrastructure:

  1. Run genlayer receipt <txHash> --stdout --stderr.
  2. Check whether execution succeeded or failed.
  3. If execution failed, fix the contract/runtime error first.
  4. Treat missing code/schema as a possible RPC, indexer, or state-read issue only when the receipt shows execution success.
ObservationLikely meaning
ACCEPTED/FINALIZED + execution error + no code/schemaExpected failed deploy; fix the contract or runtime error
ACCEPTED/FINALIZED + execution success + no code/schemaPossible RPC, indexer, or state-read issue
PENDING, missing receipt, or transaction not foundPolling, network, or transaction propagation issue

Appeal a Transaction

Challenge a transaction result to trigger re-evaluation by validators:

bash
genlayer appeal <txHash>

Local Studio Management

bash
genlayer init                               # Initialize environment
genlayer init --numValidators 10 --headless  # Customize
genlayer up                                 # Start Studio
genlayer up --reset-db                      # Fresh start
genlayer stop                               # Stop all services
Local Validator Management
bash
genlayer localnet validators get                          # List all
genlayer localnet validators count                        # Count
genlayer localnet validators create --stake 50            # Add one
genlayer localnet validators create-random --count 3      # Add multiple
genlayer localnet validators update 0x... --model gpt-4   # Change model
genlayer localnet validators delete --address 0x...       # Remove

Debugging Workflow

When a transaction fails or produces unexpected results:

  1. Get the receipt: genlayer receipt <txHash> --stdout --stderr
  2. Check execution result: lifecycle status alone is not enough; ACCEPTED/FINALIZED can contain execution errors
  3. Check contract schema: genlayer schema <address> (verify method exists, correct args)
  4. Read contract source: genlayer code <address> (verify deployed code matches local)
  5. Try a read call: genlayer call <address> <view_method> (check current state)
  6. Appeal if needed: genlayer appeal <txHash> (re-run consensus)

Project Scaffolding

bash
genlayer new myproject          # Create from template
genlayer new myproject --path ./projects/

Configuration

bash
genlayer config get                         # Show all config
genlayer config get network                 # Specific key
genlayer config set network=testnet-bradbury
genlayer config reset network               # Restore default

© internet-court, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in vendored/genlayer/genlayer-cli of internet-court/internet-court-skill.

  • SKILL.md
  • LICENSE
  • agents/openai.yaml

Open the folder on GitHubat commit fa89195

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in internet-court/internet-court-skill, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Genlayer CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Genlayer CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Genlayer CLI this skillinternet-court/internet-court-skill6.4k1 repos~2.2kAutomated safety check: NotesMIT
Monitor CInrwl/nx29k5 repos~4.7kAutomated safety check: PassMIT
Terraform and OpenTofu Guideagentscope-ai/QwenPaw35k6 repos~4.2kAutomated safety check: PassApache-2.0
Vercel Optimize Auditvercel-labs/agent-skills32k8 repos~4.3kAutomated safety check: PassNone
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence
Docs Learn PR Previewnetdata/netdata81k—~2kAutomated safety check: PassGPL-3.0

Similar skills

  • Monitor CI

    nrwl/nx

    Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 5 repos~4.7k tokens
    DevOps & CloudAuto-check passed
  • Terraform and OpenTofu Guide

    agentscope-ai/QwenPaw

    Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.

    35k GitHub starsUsed in 6 repos~4.2k tokens
    DevOps & CloudAuto-check passed
  • Vercel Optimize Audit

    vercel-labs/agent-skills

    Official

    Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.

    32k GitHub starsUsed in 8 repos~4.3k tokens
    DevOps & CloudAuto-check passed
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • Docs Learn PR Preview

    netdata/netdata

    Use only when the user explicitly asks to build, run, preview, inspect, or validate learn.netdata.cloud locally using the contents of a PR or documentation branch before merge.

    81k GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Repo Mirror Sources

    netdata/netdata

    Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.

    81k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from internet-court/internet-court-skill

All 80 skills in this repo
  • NEAR AI Cloud Private Inference

    internet-court/internet-court-skill

    Shows how to call NEAR AI Cloud through an OpenAI-compatible API and verify that inference ran in a TEE, using attestation checks and signed chat responses.

    6.4k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • NEAR Intents Swap Integration

    internet-court/internet-court-skill

    Builds cross-chain token swaps and bridge flows with the NEAR Intents 1Click API: quotes, deposit addresses, per-chain deposits and status polling.

    6.4k GitHub starsUsed in 2 repos~939 tokens
    Auto-check passed
  • Kleros IPFS Upload

    internet-court/internet-court-skill

    Uploads one Kleros-related file per paid request to IPFS through the Kleros x402 gateway for 0.01 USDC on Base, returning a CID that Kleros contracts can reference.

    6.4k GitHub stars~4.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • OKX DeFi Invest and Portfolio

    internet-court/internet-court-skill

    Finds DeFi yield products through OKX, runs deposits, withdrawals and reward claims, and shows existing DeFi positions across chains, for requests that name no specific dApp.

    6.4k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • PNP Prediction Markets on Solana

    internet-court/internet-court-skill

    Creates, trades and settles permissionless prediction markets on Solana with any SPL token as collateral, including social-media and custom-oracle markets.

    6.4k GitHub stars~7.5k tokensUpdated 1 mo ago
    Auto-check: notes
  • 0G Compute Network Guide

    internet-court/internet-court-skill

    Guides building on the 0G Compute Network, a decentralized GPU marketplace for AI inference and fine-tuning, with SDK patterns and CLI commands.

    6.4k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Categories

Questions about Genlayer CLI

What does Genlayer CLI do?

Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts. Genlayer CLI is an agent skill from internet-court/internet-court-skill. Use the GenLayer CLI to deploy, interact with, and debug intelligent contracts.

When should I use Genlayer CLI?

Genlayer CLI fits situations like: devOps & Cloud work in your project.

How do I install Genlayer CLI in Claude Code?

Run `npx skills add internet-court/internet-court-skill --skill genlayer-cli -a claude-code`. Or copy the skill folder (vendored/genlayer/genlayer-cli in internet-court/internet-court-skill) into .claude/skills/genlayer-cli in your project. Claude Code loads it when a task matches its description.

How do I install Genlayer CLI in Codex?

Run `npx skills add internet-court/internet-court-skill --skill genlayer-cli -a codex`. Or copy the skill folder (vendored/genlayer/genlayer-cli in internet-court/internet-court-skill) into .agents/skills/genlayer-cli in your project. Codex loads it when a task matches its description.

Can I use Genlayer CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add internet-court/internet-court-skill --skill genlayer-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/genlayer-cli, .gemini/skills/genlayer-cli, .github/skills/genlayer-cli and .opencode/skills/genlayer-cli in your project.

What does Genlayer CLI need to run?

Going by SKILL.md and its folder, Genlayer CLI needs the command-line tools its instructions call (npm). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash, Read.

Does Genlayer CLI access the network?

SKILL.md names 1 domain. As links in the text: testnet-faucet.genlayer.foundation. This is read from the text; nothing was executed.

Is Genlayer CLI safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Genlayer CLI use?

Genlayer CLI is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Genlayer CLI use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Genlayer CLI?

Skills that share tags, products or a category with Genlayer CLI: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 35k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Analyze GitHub Action Logs (withastro/astro, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Genlayer CLI?

internet-court (a GitHub organization) maintains it in internet-court/internet-court-skill, which has 6,397 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on August 19, 2026.

Source: internet-court/internet-court-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.