Docs · Helpers

Helpers Library

15 entries5 surfaces · 5 languages

Library

Helpers, indexed by surface and language.

Nukez Helper Scripts

A complete inventory of helper scripts are provided herein. These are convenience helpers scripts and functions used internally by the Nukez team. Each has been tested and regularly used in our actual development and production ops. None of these are necessary to use any of the Nukez integration paths. These are strictly made available as a convenience.

Browser warning. Signing helpers are command-line tools. Do not load private Solana keypair JSON in a browser. Browser apps should use a wallet adapter or a server-side signer.

Filter

Browse by surface and language

Filters are stackable. They affect the cards below; the reference matrix at the bottom always shows everything.

Showing 15 of 15 helpers.

HTTP

HTTP helpers (4)

HTTP · Shellnukez_helpers.sh

signed_call wrapper that builds the signed envelope headers from bash or zsh.

Best for: Local curl workflows and terminal smoke tests.
Runtime: bash/zsh + curl + jq
Dependencies: Pairs with one signer file (Node/Bun or Python).
Scope: signing

HTTP · JavaScriptnukez_sign.mjs

Build X-Nukez-Envelope and X-Nukez-Signature headers from Node or Bun, zero npm packages.

Best for: Node services, Bun scripts, JS-heavy toolchains.
Runtime: Node 18+ or Bun
Dependencies: Zero npm packages.
Scope: signing

HTTP · Pythonnukez_sign.py

Same envelope contract as the JS signer, using Python stdlib plus the OpenSSL CLI.

Best for: Python-only environments and backend scripts.
Runtime: Python 3.8+ + openssl
Dependencies: Zero pip packages.
Scope: signing

HTTP · Rustnukez-sign-rs.tar.gz

Native nukez-sign binary, drop-in for cargo-equipped Solana toolchains.

Best for: Solana developers and any environment with cargo.
Runtime: Rust 1.70+ + cargo
Dependencies: 9 well-known crates (clap, ed25519-dalek, bs58, base64, sha2, serde_json, hex, rand, anyhow).
Scope: signing

PyNukez

PyNukez helpers (1)

PyNukez · Pythonnukez_pay.py

Optional client-side x402 payment helper — executes the selected quote leg locally.

Best for: PyNukez automations that pay from the local machine.
Runtime: Python 3.8+
Dependencies: solana, solders, web3, eth-account, base58.
Scope: payment · SOL/SPL/MON/ERC-20

MCP

MCP helpers (3)

MCP · Pythonrpc()

Thin JSON-RPC helper that handles both JSON and text/event-stream replies.

Best for: Direct MCP clients that bypass an SDK.
Runtime: Python 3.8+
Dependencies: httpx.
Scope: transport

MCP · Pythonbuild_envelope() · compute_locker_id()

Canonical JSON envelope construction and locker-id derivation for client-signed calls.

Best for: Authenticated MCP tool calls with local Ed25519 signing.
Runtime: Python 3.8+
Dependencies: PyNaCl, base58.
Scope: signing

MCP · Pythonsolana_transfer()

Explicit solders-based Solana transfer for the payment leg of MCP-driven flows.

Best for: MCP clients that want client-side payment without PyNukez.
Runtime: Python 3.8+
Dependencies: solders.
Scope: payment · SOL

NukezAgent

NukezAgent helpers (3)

NukezAgent · Pythonnukez_context.py

Cross-agent context bridge CLI — bootstrap, persist, recall, snapshot, hydrate across agents.

Best for: Sharing verifiable context between Claude Code, Codex, Cursor, and custom agents.
Runtime: Python 3.10+
Dependencies: PyNukez + NukezAgent local bundles.
Scope: context · lifecycle

NukezAgent · Pythonsigned_headers() · agent_get · agent_post

Sign each delegate request with the local owner key, preserve extra headers, and loop signing_needed responses.

Best for: Direct NukezAgent integrations that keep keys client-side.
Runtime: Python 3.8+
Dependencies: httpx, PyNaCl, base58.
Scope: signing

NukezAgent · Pythonsign_envelopes()

Signs gateway envelopes returned in signing_needed responses without exposing the key to the agent.

Best for: Wallet bridges, passkey bridges, and adapter helpers.
Runtime: Python 3.8+
Dependencies: PyNaCl, base58.
Scope: signing

OpenClaw

OpenClaw helpers (4)

OpenClaw · Pythonnukez_cli.py

Lifecycle CLI — bootstrap, persist, attest, ritual, verify, recall — for the OpenClaw skill.

Best for: Open Claw skills and any agent that wants the five lifecycle commands.
Runtime: Python 3.11+
Dependencies: PyNukez SDK.
Scope: lifecycle

OpenClaw · Pythonnukez_pay.py

Co-located payment helper — same x402 helper as PyNukez, bundled inside the OpenClaw skill.

Best for: Skills that need to pay from the local wallet during bootstrap.
Runtime: Python 3.11+
Dependencies: solana, solders, web3, eth-account, base58.
Scope: payment · SOL/SPL/MON/ERC-20

OpenClaw · MarkdownSKILL.md

Skill manifest the host runtime reads to learn the lifecycle commands and required env.

Best for: ClawHub installs and any host that loads SKILL.md manifests.
Runtime: Open Claw runtime
Dependencies: —
Scope: agent skill · manifest

OpenClaw · MarkdownREADME.md

Skill README — install paths, prerequisites, quick start, configuration matrix.

Best for: Developers dropping the skill into their own runtime.
Runtime: Any markdown reader
Dependencies: —
Scope: agent skill · readme

Reference matrix

All helpers, unfiltered

One row per helper. The chip filters above only affect the cards; this matrix always shows the full inventory so you can scan or link to a specific entry.

Helper	Surface	Language	Kind	Scope	Source	Docs
`nukez_helpers.sh`	HTTP	Shell	Download	signing	`/helpers/nukez_helpers.sh`	HTTP helpers · Shell tab
`nukez_sign.mjs`	HTTP	JavaScript	Download	signing	`/helpers/nukez_sign.mjs`	HTTP helpers · JS tab
`nukez_sign.py`	HTTP	Python	Download	signing	`/helpers/nukez_sign.py`	HTTP helpers · Python tab
`nukez-sign-rs.tar.gz`	HTTP	Rust	Download	signing	`/helpers/nukez-sign-rs.tar.gz`	HTTP helpers · Rust tab
`nukez_pay.py`	PyNukez	Python	Download	payment · SOL/SPL/MON/ERC-20	`/helpers/pynukez/nukez_pay.py`	PyNukez helpers
`rpc()`	MCP	Python	Inline · doc	transport	`/docs/mcp/examples`	MCP examples · Setup
`build_envelope() · compute_locker_id()`	MCP	Python	Inline · doc	signing	`/docs/mcp/examples`	MCP examples · Envelope helpers
`solana_transfer()`	MCP	Python	Inline · doc	payment · SOL	`/docs/mcp/examples`	MCP examples · Payment helper
`nukez_context.py`	NukezAgent	Python	Download	context · lifecycle	`/helpers/nukezagent/nukez_context.py`	NukezAgent overview
`signed_headers() · agent_get · agent_post`	NukezAgent	Python	Inline · doc	signing	`/docs/nukezagent/examples`	NukezAgent examples · Request helpers
`sign_envelopes()`	NukezAgent	Python	Inline · doc	signing	`/docs/nukezagent/signing-bridge`	NukezAgent · Signing bridge
`nukez_cli.py`	OpenClaw	Python	Download	lifecycle	`/helpers/openclaw/nukez_cli.py`	OpenClaw case study
`nukez_pay.py`	OpenClaw	Python	Download	payment · SOL/SPL/MON/ERC-20	`/helpers/openclaw/nukez_pay.py`	OpenClaw case study
`SKILL.md`	OpenClaw	Markdown	Agent skill	agent skill · manifest	`/helpers/openclaw/SKILL.md`	OpenClaw case study
`README.md`	OpenClaw	Markdown	Agent skill	agent skill · readme	`/helpers/openclaw/README.md`	OpenClaw case study

§ next