Skip to content
View degenhood's full-sized avatar

Block or report degenhood

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
DegenHood/README.md

DegenHood developer toolkit

CI CodeQL SDK on npm CLI on npm

Public developer tooling for preparing and verifying DegenHood token launches on Robinhood Chain (chain ID 4663).

This repository is intentionally limited to the public integration surface. It does not contain the production application, deployment configuration, contract source, operator procedures, or credentials.

Packages

Package Purpose
@degenhood/sdk Build requests, call the preparation API, verify returned calldata, and inspect indexed launches
@degenhood/cli Prepare, verify, simulate, and inspect launches from a terminal

Both packages are MIT licensed and require Node.js 20 or newer.

npm install @degenhood/sdk@0.1.0
npm install @degenhood/cli@0.1.0

SDK quickstart

import {
  createDegenHoodClient,
  verifyLaunchPreparation
} from "@degenhood/sdk";

const client = createDegenHoodClient({
  baseUrl: "https://api.degenhood.fun",
  accessToken: process.env.DEGENHOOD_ACCESS_TOKEN
});

const preparation = await client.prepareLaunch({
  name: "Example Hood",
  symbol: "EXAMPLE",
  launcher: account,
  tokenAdmin: account,
  feeAdmin: account,
  beneficiary: account,
  templateId: 2
});

verifyLaunchPreparation(preparation);

The response contains a predicted ...de6 token address and an unsigned, zero-value transaction. The SDK does not accept wallet keys, sign transactions, pay gas, or broadcast.

See the complete external-wallet flow in examples/developer/prepare-launch.ts. Production launch preparation is currently wallet-allowlisted.

CLI quickstart

Start with examples/developer/token.example.json, then:

export DEGENHOOD_ACCESS_TOKEN="your-short-lived-token"

npx @degenhood/cli@0.1.0 launch prepare \
  --file examples/developer/token.example.json \
  --account 0xYourCreatorWallet \
  > preparation.json

npx @degenhood/cli@0.1.0 launch verify --file preparation.json

Optional simulation uses eth_estimateGas and eth_call only:

npx @degenhood/cli@0.1.0 launch simulate \
  --file preparation.json \
  --rpc https://rpc.mainnet.chain.robinhood.com

Review the full command reference in packages/cli/README.md.

API and agent integration

To install the skill for a local Codex setup:

mkdir -p ~/.codex/skills
cp -R skills/prepare-degenhood-launch ~/.codex/skills/

The skill fails closed and explicitly prohibits requesting keys, signing, deploying, moving funds, or broadcasting.

Verification

npm ci --prefix packages/sdk
npm ci --prefix packages/cli
npm test
npm run verify:packages

verify:packages creates the exact npm tarballs, checks their contents against an allowlist, then installs and exercises them in an empty temporary project.

Run the optional production read-only smoke check with a known indexed token:

DEGENHOOD_API_URL=https://api.degenhood.fun \
DEGENHOOD_TOKEN=0xTokenAddress \
npm run smoke:read-only

No authentication is used unless the explicit preparation-smoke flag is enabled.

Security

Please report vulnerabilities privately through GitHub Security Advisories. Never include live keys, access tokens, funded-wallet signatures, or credentials in an issue.

License

MIT

Popular repositories Loading

  1. DegenHood DegenHood Public

    Official SDK, CLI, API specification, examples, and agent skill for unsigned DegenHood launch preparation on Robinhood Chain.

    JavaScript