@overcast-xyz/cli 0.1.0

package/dist/commands/withdraw.js

@@ -0,0 +1,67 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withdraw = withdraw;
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const client_1 = require("../client");
+const config_1 = require("../config");
+const shared_1 = require("./shared");
+/** `overcast withdraw` — pull funds back out of the wallet's escrow vault. */
+async function withdraw(opts) {
+    const config = (0, config_1.resolveConfig)(opts);
+    const app = await (0, client_1.createClient)(config);
+    const mint = opts.mint ?? (await (0, shared_1.promptMint)("Mint to withdraw"));
+    const amount = opts.amount
+        ? BigInt(opts.amount)
+        : await (0, shared_1.promptAmount)("Amount to withdraw (native units)");
+    const spinner = p.spinner();
+    spinner.start(`Withdrawing ${amount} of ${mint}`);
+    try {
+        const { hash } = await app.chain.withdraw({
+            withdrawer: app.publicKey,
+            mint,
+            amount,
+        });
+        spinner.stop(picocolors_1.default.green(`Withdrew. tx ${picocolors_1.default.bold(hash)}`));
+    }
+    catch (err) {
+        spinner.stop(picocolors_1.default.red(`Withdraw failed: ${err.message}`));
+        throw err;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,53 @@
+import { SolanaConfig } from "@overcast-xyz/solana-client";
+/** Connection + wallet configuration resolved from CLI flags and the environment. */
+export interface CliConfig {
+    /** Solana RPC endpoint. */
+    rpcUrl: string;
+    /** Base URL of the Overcast backend (the RFQ socket.io server). */
+    backendUrl: string;
+    /**
+     * Inlined signing key material — a raw JSON byte array string or a
+     * base58-encoded secret key. Any `id.json` file path is already resolved to
+     * its contents here, so `solana-client` never touches the filesystem.
+     *
+     * `undefined` for a read-only client (no keypair supplied): on-chain reads
+     * work, but anything that signs / needs a wallet identity will throw.
+     */
+    privateKey?: string;
+    /**
+     * The transport to use, either websocket or polling
+     */
+    transport?: "polling" | "websocket";
+}
+/** Global flags every command accepts (set on the root commander program). */
+export interface GlobalFlags {
+    keypair?: string;
+    rpc?: string;
+    backend?: string;
+    transport?: "polling" | "websocket";
+}
+/** Options controlling how {@link resolveConfig} treats a missing keypair. */
+export interface ResolveConfigOptions {
+    /**
+     * Allow the keypair to be absent — for read-only commands that never sign.
+     * The resulting {@link CliConfig.privateKey} is `undefined` and the client is
+     * built read-only. Defaults to `false` (a wallet is required).
+     */
+    keypairOptional?: boolean;
+}
+/**
+ * Resolve {@link CliConfig} from flags first, then environment, then localhost
+ * defaults. The keypair is required unless `keypairOptional` is set (read-only
+ * commands); everything else has a sane default.
+ *
+ * Keypair sources (via `--keypair` or `OVERCAST_KEYPAIR`):
+ * - a path to a Solana CLI `id.json` file,
+ * - a raw JSON byte array string, or
+ * - a base58-encoded secret key string.
+ *
+ * A file path is read here (the CLI owns filesystem access) so only inlined key
+ * material is handed to `solana-client`.
+ */
+export declare function resolveConfig(flags: GlobalFlags, options?: ResolveConfigOptions): CliConfig;
+/** Map the CLI config onto the {@link SolanaConfig} the client + signer expect. */
+export declare function toSolanaConfig(config: CliConfig): SolanaConfig;

package/dist/config.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = resolveConfig;
+exports.toSolanaConfig = toSolanaConfig;
+const fs_1 = require("fs");
+const solana_program_1 = require("@overcast-xyz/solana-program");
+const DEFAULT_RPC_URL = "http://127.0.0.1:8899";
+const DEFAULT_BACKEND_URL = "http://127.0.0.1:3000";
+/**
+ * Resolve {@link CliConfig} from flags first, then environment, then localhost
+ * defaults. The keypair is required unless `keypairOptional` is set (read-only
+ * commands); everything else has a sane default.
+ *
+ * Keypair sources (via `--keypair` or `OVERCAST_KEYPAIR`):
+ * - a path to a Solana CLI `id.json` file,
+ * - a raw JSON byte array string, or
+ * - a base58-encoded secret key string.
+ *
+ * A file path is read here (the CLI owns filesystem access) so only inlined key
+ * material is handed to `solana-client`.
+ */
+function resolveConfig(flags, options = {}) {
+    const rpcUrl = flags.rpc ?? process.env.SOLANA_RPC_URL ?? DEFAULT_RPC_URL;
+    const backendUrl = flags.backend ?? process.env.OVERCAST_BACKEND_URL ?? DEFAULT_BACKEND_URL;
+    const rawKey = flags.keypair ?? process.env.OVERCAST_KEYPAIR;
+    if (!rawKey && !options.keypairOptional) {
+        throw new Error("no wallet: pass --keypair <path|base58|json> or set OVERCAST_KEYPAIR");
+    }
+    return {
+        rpcUrl,
+        backendUrl,
+        privateKey: rawKey ? maybeReadFile(rawKey) : undefined,
+        transport: flags.transport,
+    };
+}
+/** Map the CLI config onto the {@link SolanaConfig} the client + signer expect. */
+function toSolanaConfig(config) {
+    return {
+        rpcUrl: config.rpcUrl,
+        backend: config.backendUrl,
+        privateKey: config.privateKey,
+        domain: solana_program_1.SOLANA_DOMAIN,
+        transport: config.transport,
+    };
+}
+/** If `raw` points at an existing file, return its contents; otherwise `raw`. */
+function maybeReadFile(raw) {
+    const trimmed = raw.trim();
+    // A base58 secret key or JSON array never looks like a plausible file path.
+    if (trimmed.startsWith("["))
+        return trimmed;
+    try {
+        return (0, fs_1.readFileSync)(trimmed, "utf8").trim();
+    }
+    catch {
+        return trimmed;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@overcast-xyz/cli` — programmatic entry points. The executable lives in `bin.ts`;
+ * these exports let the command implementations be reused or tested.
+ */
+export * from "./config";
+export * from "./client";
+export { deposit } from "./commands/deposit";
+export { withdraw } from "./commands/withdraw";
+export { balance } from "./commands/balance";
+export { optionShow, optionList } from "./commands/option";
+export { offerShow, offerList } from "./commands/offer";
+export { assetsList } from "./commands/assets";
+export { accept } from "./commands/accept";
+export { exercise } from "./commands/exercise";
+export { keyAdd, keyRemove } from "./commands/key";
+export { redeem } from "./commands/redeem";
+export { rfqCreate } from "./commands/rfq";
+export { runQuoter } from "./commands/quote";

package/dist/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runQuoter = exports.rfqCreate = exports.redeem = exports.keyRemove = exports.keyAdd = exports.exercise = exports.accept = exports.assetsList = exports.offerList = exports.offerShow = exports.optionList = exports.optionShow = exports.balance = exports.withdraw = exports.deposit = void 0;
+/**
+ * `@overcast-xyz/cli` — programmatic entry points. The executable lives in `bin.ts`;
+ * these exports let the command implementations be reused or tested.
+ */
+__exportStar(require("./config"), exports);
+__exportStar(require("./client"), exports);
+var deposit_1 = require("./commands/deposit");
+Object.defineProperty(exports, "deposit", { enumerable: true, get: function () { return deposit_1.deposit; } });
+var withdraw_1 = require("./commands/withdraw");
+Object.defineProperty(exports, "withdraw", { enumerable: true, get: function () { return withdraw_1.withdraw; } });
+var balance_1 = require("./commands/balance");
+Object.defineProperty(exports, "balance", { enumerable: true, get: function () { return balance_1.balance; } });
+var option_1 = require("./commands/option");
+Object.defineProperty(exports, "optionShow", { enumerable: true, get: function () { return option_1.optionShow; } });
+Object.defineProperty(exports, "optionList", { enumerable: true, get: function () { return option_1.optionList; } });
+var offer_1 = require("./commands/offer");
+Object.defineProperty(exports, "offerShow", { enumerable: true, get: function () { return offer_1.offerShow; } });
+Object.defineProperty(exports, "offerList", { enumerable: true, get: function () { return offer_1.offerList; } });
+var assets_1 = require("./commands/assets");
+Object.defineProperty(exports, "assetsList", { enumerable: true, get: function () { return assets_1.assetsList; } });
+var accept_1 = require("./commands/accept");
+Object.defineProperty(exports, "accept", { enumerable: true, get: function () { return accept_1.accept; } });
+var exercise_1 = require("./commands/exercise");
+Object.defineProperty(exports, "exercise", { enumerable: true, get: function () { return exercise_1.exercise; } });
+var key_1 = require("./commands/key");
+Object.defineProperty(exports, "keyAdd", { enumerable: true, get: function () { return key_1.keyAdd; } });
+Object.defineProperty(exports, "keyRemove", { enumerable: true, get: function () { return key_1.keyRemove; } });
+var redeem_1 = require("./commands/redeem");
+Object.defineProperty(exports, "redeem", { enumerable: true, get: function () { return redeem_1.redeem; } });
+var rfq_1 = require("./commands/rfq");
+Object.defineProperty(exports, "rfqCreate", { enumerable: true, get: function () { return rfq_1.rfqCreate; } });
+var quote_1 = require("./commands/quote");
+Object.defineProperty(exports, "runQuoter", { enumerable: true, get: function () { return quote_1.runQuoter; } });

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@overcast-xyz/cli",
+  "version": "0.1.0",
+  "description": "CLI for the Overcast Solana protocol: deposits, withdrawals and the RFQ engine (user + RFQ quoter).",
+  "license": "Apache-2.0",
+  "author": "info@overcast.xyz",
+  "keywords": [
+    "solana",
+    "overcast-cli"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "overcast": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "@overcast-xyz/solana-program": "0.1.1",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "@overcast-xyz/solana-client": "0.1.0",
+    "@overcast-xyz/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.28.1",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "bundle": "node build.mjs",
+    "clean": "rm -rf dist dist-bundle index.js",
+    "start": "node dist/bin.js"
+  }
+}