@chest-gate/cli 0.1.0

package/dist/manifest.js

@@ -0,0 +1,171 @@
+/**
+ * app.md manifest, the authoring-side artifact for an App (an install-ready
+ * agent capability that wraps one or more paid Gates).
+ *
+ * Authors keep an `app.md` in their repo with YAML frontmatter declaring the
+ * App's identity, the upstream Gates it calls, and human-readable metadata.
+ * The markdown body becomes the listing description on chest.sh.
+ *
+ * The payout wallet is **deliberately not a manifest field**, it is resolved
+ * from the on-chain author record (npm/crates.io/Hugging Face pattern).
+ * Wallet rotation, multi-sig payouts, and impersonation prevention all live
+ * on the author record, not in every manifest.
+ *
+ * Hand-rolled validator (no zod dep). Returns either a typed manifest or
+ * a structured list of errors with field paths so the CLI can render them
+ * with line/column hints.
+ */
+import { readFile } from "node:fs/promises";
+import matter from "gray-matter";
+export const CAPABILITY_TAGS = [
+    "INFERENCE",
+    "SEARCH",
+    "DATA",
+    "MEDIA",
+    "INFRA",
+];
+const NAME_PATTERN = /^[a-z0-9-]+$/;
+const AUTHOR_PATTERN = /^@[a-z0-9-]+$/;
+const SLUG_PATTERN = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/;
+const HTTPS_PATTERN = /^https:\/\/[^\s]+$/;
+/**
+ * Parse and validate an app.md manifest from disk. Returns either the
+ * typed manifest (`{ ok: true, manifest }`) or a list of errors.
+ */
+export async function loadManifest(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf-8");
+    }
+    catch (err) {
+        return {
+            ok: false,
+            errors: [{ path: "<file>", message: `Cannot read ${path}: ${err.message}` }],
+        };
+    }
+    return parseManifest(raw);
+}
+/**
+ * Parse and validate a manifest from a raw string. Exposed separately so
+ * tests don't need a real file on disk.
+ */
+export function parseManifest(raw) {
+    let parsed;
+    try {
+        const result = matter(raw);
+        parsed = { data: result.data ?? {}, content: result.content ?? "" };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            errors: [{ path: "<frontmatter>", message: `Invalid YAML: ${err.message}` }],
+        };
+    }
+    const errors = [];
+    const data = parsed.data;
+    // name
+    const name = data.name;
+    if (typeof name !== "string" || name.length === 0) {
+        errors.push({ path: "name", message: "required, must be a non-empty string" });
+    }
+    else if (name.length > 64) {
+        errors.push({ path: "name", message: "must be ≤ 64 chars" });
+    }
+    else if (!NAME_PATTERN.test(name)) {
+        errors.push({ path: "name", message: "must match [a-z0-9-]+ (kebab-case)" });
+    }
+    // author
+    const author = data.author;
+    if (typeof author !== "string" || author.length === 0) {
+        errors.push({ path: "author", message: "required, must be a non-empty string" });
+    }
+    else if (!AUTHOR_PATTERN.test(author)) {
+        errors.push({ path: "author", message: "must start with @ and match @[a-z0-9-]+" });
+    }
+    // version
+    const version = data.version;
+    if (typeof version !== "string" || version.length === 0) {
+        errors.push({ path: "version", message: "required, must be a non-empty string" });
+    }
+    else if (!SEMVER_PATTERN.test(version)) {
+        errors.push({ path: "version", message: `'${version}' is not valid semver` });
+    }
+    // description
+    const description = data.description;
+    if (typeof description !== "string" || description.length === 0) {
+        errors.push({ path: "description", message: "required, must be a non-empty string" });
+    }
+    else if (description.length > 280) {
+        errors.push({ path: "description", message: `${description.length} chars > 280 max` });
+    }
+    // capabilityTags
+    const tags = data.capabilityTags;
+    if (!Array.isArray(tags) || tags.length === 0) {
+        errors.push({ path: "capabilityTags", message: "required, must be a non-empty array" });
+    }
+    else {
+        tags.forEach((t, i) => {
+            if (typeof t !== "string" || !CAPABILITY_TAGS.includes(t)) {
+                errors.push({
+                    path: `capabilityTags[${i}]`,
+                    message: `'${String(t)}' is not one of ${CAPABILITY_TAGS.join(", ")}`,
+                });
+            }
+        });
+    }
+    // upstreamGates (optional)
+    const gates = data.upstreamGates;
+    if (gates !== undefined && gates !== null) {
+        if (!Array.isArray(gates)) {
+            errors.push({ path: "upstreamGates", message: "must be an array of @author/name slugs" });
+        }
+        else {
+            gates.forEach((g, i) => {
+                if (typeof g !== "string" || !SLUG_PATTERN.test(g)) {
+                    errors.push({
+                        path: `upstreamGates[${i}]`,
+                        message: `'${String(g)}' must match @author/app-name`,
+                    });
+                }
+            });
+        }
+    }
+    // homepage (optional)
+    if (data.homepage !== undefined && data.homepage !== null) {
+        if (typeof data.homepage !== "string" || !HTTPS_PATTERN.test(data.homepage)) {
+            errors.push({ path: "homepage", message: "must be an https:// URL" });
+        }
+    }
+    // repository (optional)
+    if (data.repository !== undefined && data.repository !== null) {
+        if (typeof data.repository !== "string" || !HTTPS_PATTERN.test(data.repository)) {
+            errors.push({ path: "repository", message: "must be an https:// URL" });
+        }
+    }
+    // license (optional, free-form string for v1, full SPDX list is too large
+    // to enforce here; the registry will warn on unknown identifiers later)
+    if (data.license !== undefined && data.license !== null) {
+        if (typeof data.license !== "string" || data.license.length === 0) {
+            errors.push({ path: "license", message: "must be a non-empty string (SPDX identifier)" });
+        }
+    }
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return {
+        ok: true,
+        manifest: {
+            name: name,
+            author: author,
+            version: version,
+            description: description,
+            capabilityTags: tags,
+            upstreamGates: gates ? gates : undefined,
+            homepage: data.homepage ? data.homepage : undefined,
+            repository: data.repository ? data.repository : undefined,
+            license: data.license ? data.license : undefined,
+            body: parsed.content,
+        },
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/splitter-init.d.ts

@@ -0,0 +1,32 @@
+import pkg from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+export declare const CHEST_PROTOCOL_WALLET: pkg.web3.PublicKey;
+export declare const RPC_URLS: Record<string, string>;
+export interface SplitInitResult {
+    splitConfigPda: string;
+    vaultPda: string;
+    merchantTokenAccount: string;
+    protocolTokenAccount: string;
+    txSignature: string;
+}
+export declare function computeSlugHash(slug: string): Buffer;
+/**
+ * Derive the split_config and vault PDAs for a given authority + slug + mint.
+ */
+export declare function deriveSplitPdas(authority: PublicKey, slug: string, usdcMint: PublicKey): Promise<{
+    splitConfigPda: PublicKey;
+    vaultPda: PublicKey;
+}>;
+/**
+ * Initialize a split config on-chain for the given merchant + slug.
+ * Creates the SplitConfig PDA, vault PDA, and merchant/protocol ATAs if needed.
+ */
+export declare function initializeSplit(opts: {
+    feePayerKeypair: Uint8Array;
+    merchantWallet: string;
+    usdcMintAddress: string;
+    slug: string;
+    referrerBps: number;
+    network: string;
+}): Promise<SplitInitResult>;
+//# sourceMappingURL=splitter-init.d.ts.map

package/dist/splitter-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitter-init.d.ts","sourceRoot":"","sources":["../src/splitter-init.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,mBAAmB,CAAC;AAEpC,OAAO,EAAuB,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAgBhF,eAAO,MAAM,qBAAqB,oBAGjC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM3C,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,GAClB,OAAO,CAAC;IAAE,cAAc,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC,CAY7D;AAkCD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,eAAe,EAAE,UAAU,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuD3B"}

package/dist/splitter-init.js

@@ -0,0 +1,99 @@
+import pkg from "@coral-xyz/anchor";
+const { AnchorProvider, Program, Wallet, setProvider } = pkg;
+import { Connection, Keypair, PublicKey, SystemProgram } from "@solana/web3.js";
+import { TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID, getAssociatedTokenAddress, createAssociatedTokenAccountInstruction, getAccount, } from "@solana/spl-token";
+import { createHash } from "crypto";
+import idl from "./chest_splitter_idl.json" with { type: "json" };
+const PROGRAM_ID = new PublicKey("9a6zrqau5xVEdxNqBUfL2G18WuryQbWeJScPAUHZvmmX");
+// Chest treasury wallet, receives protocol fee (1.5%).
+// Override with CHEST_PROTOCOL_WALLET env var for production.
+// Default is the Chest devnet treasury (our Solana CLI keypair).
+export const CHEST_PROTOCOL_WALLET = new PublicKey(process.env.CHEST_PROTOCOL_WALLET ||
+    "HndLQmUiUzi6mn1BHUrMWuNKzagvPfPQSkXFm6tC7wev");
+export const RPC_URLS = {
+    "solana-devnet": "https://api.devnet.solana.com",
+    "solana-mainnet": "https://api.mainnet-beta.solana.com",
+    devnet: "https://api.devnet.solana.com",
+    mainnet: "https://api.mainnet-beta.solana.com",
+    localnet: "http://localhost:8899",
+};
+export function computeSlugHash(slug) {
+    return createHash("sha256").update(slug).digest().slice(0, 8);
+}
+/**
+ * Derive the split_config and vault PDAs for a given authority + slug + mint.
+ */
+export async function deriveSplitPdas(authority, slug, usdcMint) {
+    const slugHash = computeSlugHash(slug);
+    const [splitConfigPda] = PublicKey.findProgramAddressSync([Buffer.from("split"), authority.toBuffer(), slugHash], PROGRAM_ID);
+    // Vault is now ATA(split_config_pda, mint), allowOwnerOffCurve = true for PDA owner
+    const vaultPda = await getAssociatedTokenAddress(usdcMint, splitConfigPda, true);
+    return { splitConfigPda, vaultPda };
+}
+/**
+ * Ensure an ATA exists for a wallet; create it if missing.
+ * Returns the ATA address.
+ */
+async function ensureAta(connection, payer, mint, owner) {
+    const ata = await getAssociatedTokenAddress(mint, owner);
+    try {
+        await getAccount(connection, ata);
+        return ata;
+    }
+    catch {
+        // ATA doesn't exist, create it
+        const ix = createAssociatedTokenAccountInstruction(payer.publicKey, ata, owner, mint);
+        const { sendAndConfirmTransaction, Transaction } = await import("@solana/web3.js");
+        const tx = new Transaction().add(ix);
+        await sendAndConfirmTransaction(connection, tx, [payer]);
+        return ata;
+    }
+}
+/**
+ * Initialize a split config on-chain for the given merchant + slug.
+ * Creates the SplitConfig PDA, vault PDA, and merchant/protocol ATAs if needed.
+ */
+export async function initializeSplit(opts) {
+    const rpcUrl = RPC_URLS[opts.network] ?? opts.network;
+    const connection = new Connection(rpcUrl, "confirmed");
+    const authority = Keypair.fromSecretKey(opts.feePayerKeypair);
+    const wallet = new Wallet(authority);
+    const provider = new AnchorProvider(connection, wallet, {
+        commitment: "confirmed",
+    });
+    setProvider(provider);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const program = new Program(idl, provider);
+    const merchantWallet = new PublicKey(opts.merchantWallet);
+    const usdcMint = new PublicKey(opts.usdcMintAddress);
+    const slugHash = computeSlugHash(opts.slug);
+    const slugHashArray = Array.from(slugHash);
+    const { splitConfigPda, vaultPda } = await deriveSplitPdas(authority.publicKey, opts.slug, usdcMint);
+    // Ensure merchant and protocol ATAs exist before initializing
+    const [merchantAta, protocolAta] = await Promise.all([
+        ensureAta(connection, authority, usdcMint, merchantWallet),
+        ensureAta(connection, authority, usdcMint, CHEST_PROTOCOL_WALLET),
+    ]);
+    const txSignature = await program.methods
+        .initializeSplit(slugHashArray, opts.referrerBps)
+        .accounts({
+        authority: authority.publicKey,
+        merchantWallet,
+        protocolWallet: CHEST_PROTOCOL_WALLET,
+        usdcMint,
+        splitConfig: splitConfigPda,
+        vault: vaultPda,
+        tokenProgram: TOKEN_PROGRAM_ID,
+        associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+        systemProgram: SystemProgram.programId,
+    })
+        .rpc();
+    return {
+        splitConfigPda: splitConfigPda.toBase58(),
+        vaultPda: vaultPda.toBase58(),
+        merchantTokenAccount: merchantAta.toBase58(),
+        protocolTokenAccount: protocolAta.toBase58(),
+        txSignature,
+    };
+}
+//# sourceMappingURL=splitter-init.js.map

package/dist/splitter-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitter-init.js","sourceRoot":"","sources":["../src/splitter-init.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@chest-gate/cli",
+  "version": "0.1.0",
+  "description": "Chest Gate CLI. One command to monetise any API with x402 on Solana.",
+  "keywords": [
+    "x402",
+    "solana",
+    "cli",
+    "chest-gate",
+    "monetization",
+    "usdc",
+    "agent"
+  ],
+  "homepage": "https://chest.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chesthq/packages.git",
+    "directory": "cli"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "chest-gate": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@chest-gate/proxy": "^0.1.0",
+    "@coral-xyz/anchor": "^0.32.1",
+    "@solana/kit": "^5.5.0",
+    "@solana/spl-token": "^0.4.14",
+    "@solana/web3.js": "^1.98.4",
+    "bip39": "^3.1.0",
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "ed25519-hd-key": "^1.3.0",
+    "gray-matter": "^4.0.3",
+    "inquirer": "^12.0.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}