persolator-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Persolator (https://persolator.xyz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,255 @@
+# persolator-cli
+
+> Official CLI for [Persolator](https://persolator.xyz) — permissionless perpetual futures on Solana Devnet.
+
+```
+  PERSOLATOR · CLI · Solana Devnet Tooling
+  https://persolator.xyz
+```
+
+## What is this?
+
+`persolator-cli` lets you interact with the Persolator protocol from your terminal:
+
+- **Create SPL tokens** on Solana devnet — ready to launch as perpetual futures markets
+- **Request devnet SOL** airdrops to pay for transaction fees
+- **List active markets** from the Persolator protocol
+
+No VPS or server required. Everything runs on your local machine against Solana devnet.
+
+---
+
+## Installation
+
+```bash
+npm install -g persolator-cli
+```
+
+Or use without installing:
+
+```bash
+npx persolator-cli --help
+```
+
+---
+
+## Requirements
+
+- **Node.js** >= 18
+- **Solana keypair** — generate one with the Solana CLI:
+
+```bash
+# Install Solana CLI
+sh -c "$(curl -sSfL https://release.solana.com/stable/install)"
+
+# Generate a new keypair (saved to ~/.config/solana/id.json)
+solana-keygen new
+```
+
+---
+
+## Commands
+
+### `persolator airdrop`
+
+Request devnet SOL to your wallet (needed to pay for transaction fees).
+
+```bash
+persolator airdrop
+# Requests 2 SOL by default
+
+persolator airdrop --amount 5
+# Max 5 SOL per request (Solana devnet limit)
+
+persolator airdrop --keypair ./my-wallet.json
+```
+
+**Options:**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-a, --amount <sol>` | `2` | SOL amount (0.1 – 5) |
+| `-k, --keypair <path>` | `~/.config/solana/id.json` | Path to keypair file |
+| `--rpc <url>` | Solana devnet | Custom RPC endpoint |
+
+---
+
+### `persolator create-token`
+
+Create a new SPL token on Solana devnet. The mint address it generates can be used to launch a perpetual futures market on Persolator.
+
+```bash
+# Minimal — just name and symbol
+persolator create-token --name "My Token" --symbol MTK
+
+# With initial supply (minted to your wallet)
+persolator create-token \
+  --name "Test USDC" \
+  --symbol tUSDC \
+  --decimals 6 \
+  --supply 1000000
+
+# Custom keypair
+persolator create-token \
+  --name "My Token" \
+  --symbol MTK \
+  --keypair ./deployer.json
+```
+
+**Options:**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-n, --name <name>` | required | Token name |
+| `-s, --symbol <symbol>` | required | Token symbol (e.g. MTK) |
+| `-d, --decimals <n>` | `9` | Number of decimal places |
+| `--supply <amount>` | — | Initial token supply (optional) |
+| `-k, --keypair <path>` | `~/.config/solana/id.json` | Path to keypair file |
+| `--rpc <url>` | Solana devnet | Custom RPC endpoint |
+
+**Output example:**
+
+```
+  ─────────────────────────────────────────────────────
+  → Token Created Successfully
+  ─────────────────────────────────────────────────────
+    Name                 My Token
+    Symbol               MTK
+    Mint Address         7xK4mPqR...YZab
+    Decimals             9
+    Authority            8Fgh3...mNop
+    Explorer             https://explorer.solana.com/address/7xK4...?cluster=devnet
+  ─────────────────────────────────────────────────────
+
+  ✓ Mint address ready to use on Persolator!
+
+  → Next step — launch a perpetual market on Persolator:
+  →   https://persolator.xyz/launch
+  →   Paste this mint address: 7xK4mPqR...YZab
+```
+
+---
+
+### `persolator markets`
+
+List all active markets on the Persolator protocol.
+
+```bash
+persolator markets
+
+# Point to a self-hosted instance
+persolator markets --api https://api.persolator.xyz
+```
+
+**Options:**
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--api <url>` | `https://api.persolator.xyz` | Persolator API base URL |
+
+---
+
+## Full Workflow: From Zero to Market
+
+```bash
+# 1. Install the CLI
+npm install -g persolator-cli
+
+# 2. Generate a Solana keypair (skip if you already have one)
+solana-keygen new
+# Saves to: ~/.config/solana/id.json
+
+# 3. Get devnet SOL for transaction fees
+persolator airdrop --amount 2
+
+# 4. Create your SPL token
+persolator create-token \
+  --name "My Project Token" \
+  --symbol MPT \
+  --decimals 9
+
+# 5. Copy the mint address from the output, then go to:
+#    https://persolator.xyz/launch
+#    Paste the mint address → configure leverage, fees → sign & deploy
+
+# 6. Verify your market is live
+persolator markets
+```
+
+---
+
+## Keypair Options
+
+The CLI looks for a keypair in this order:
+
+1. `--keypair <path>` flag
+2. `$SOLANA_KEYPAIR` environment variable
+3. `~/.config/solana/id.json` (Solana CLI default)
+
+```bash
+# Use environment variable
+export SOLANA_KEYPAIR=/path/to/id.json
+persolator create-token --name "Test" --symbol TST
+
+# Use flag
+persolator create-token --name "Test" --symbol TST --keypair ./my-key.json
+```
+
+---
+
+## Custom RPC
+
+By default the CLI connects to Solana's public devnet RPC. For better performance you can use a private endpoint:
+
+```bash
+persolator create-token \
+  --name "Test" \
+  --symbol TST \
+  --rpc https://api.devnet.solana.com
+```
+
+Free devnet RPC providers: [Helius](https://helius.dev), [QuickNode](https://quicknode.com), [Alchemy](https://alchemy.com)
+
+---
+
+## Programmatic Usage
+
+The CLI is also importable as a library:
+
+```ts
+import { cmdCreateToken } from "persolator-cli/commands/create-token";
+
+await cmdCreateToken({
+  name: "My Token",
+  symbol: "MTK",
+  decimals: "9",
+  supply: "1000000",
+  keypair: "./id.json",
+});
+```
+
+---
+
+## Security
+
+- **Never share your keypair file.** It contains your private key.
+- The CLI only connects to Solana **devnet** by default — no real funds are at risk.
+- All source code is open source: [github.com/persolator/persolator-cli](https://github.com/persolator/persolator-cli)
+
+---
+
+## Links
+
+| | |
+|--|--|
+| Website | https://persolator.xyz |
+| App | https://persolator.xyz/markets |
+| GitHub | https://github.com/persolator |
+| X / Twitter | https://x.com/persolator_xyz |
+| npm | https://npmjs.com/package/persolator-cli |
+
+---
+
+## License
+
+MIT © [Persolator](https://persolator.xyz)

package/dist/commands/airdrop.d.ts

@@ -0,0 +1,7 @@
+export interface AirdropOptions {
+    amount: string;
+    keypair?: string;
+    rpc?: string;
+}
+export declare function cmdAirdrop(opts: AirdropOptions): Promise<void>;
+//# sourceMappingURL=airdrop.d.ts.map

package/dist/commands/airdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airdrop.d.ts","sourceRoot":"","sources":["../../src/commands/airdrop.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,iBA2DpD"}

package/dist/commands/airdrop.js

@@ -0,0 +1,55 @@
+import { Connection, LAMPORTS_PER_SOL, clusterApiUrl } from "@solana/web3.js";
+import { loadKeypair } from "../lib/keypair.js";
+import { header, success, info, error, label, divider } from "../lib/logger.js";
+import ora from "ora";
+export async function cmdAirdrop(opts) {
+    header();
+    const amount = parseFloat(opts.amount);
+    if (isNaN(amount) || amount <= 0 || amount > 5) {
+        error("Amount must be between 0.1 and 5 SOL (devnet limit)");
+        process.exit(1);
+    }
+    let keypair;
+    try {
+        keypair = loadKeypair(opts.keypair);
+    }
+    catch (e) {
+        error(e.message);
+        process.exit(1);
+    }
+    const rpcUrl = opts.rpc ?? clusterApiUrl("devnet");
+    const connection = new Connection(rpcUrl, "confirmed");
+    const balanceBefore = await connection.getBalance(keypair.publicKey);
+    const spinner = ora({
+        text: `Requesting ${amount} SOL airdrop on devnet...`,
+        color: "cyan",
+    }).start();
+    try {
+        const sig = await connection.requestAirdrop(keypair.publicKey, amount * LAMPORTS_PER_SOL);
+        spinner.text = "Confirming airdrop transaction...";
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+        await connection.confirmTransaction({ signature: sig, blockhash, lastValidBlockHeight }, "confirmed");
+        const balanceAfter = await connection.getBalance(keypair.publicKey);
+        spinner.succeed("Airdrop confirmed!");
+        console.log("");
+        divider();
+        info("Airdrop Details");
+        divider();
+        label("Wallet", keypair.publicKey.toBase58());
+        label("Amount", `${amount} SOL`);
+        label("Balance before", `${(balanceBefore / LAMPORTS_PER_SOL).toFixed(4)} SOL`);
+        label("Balance after", `${(balanceAfter / LAMPORTS_PER_SOL).toFixed(4)} SOL`);
+        label("Tx Signature", sig);
+        label("Explorer", `https://explorer.solana.com/tx/${sig}?cluster=devnet`);
+        divider();
+        console.log("");
+        success("Airdrop complete! You can now create tokens and launch markets.");
+        console.log("");
+    }
+    catch (e) {
+        spinner.fail("Airdrop failed");
+        error(e.message ?? String(e));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=airdrop.js.map

package/dist/commands/airdrop.js.map

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

package/dist/commands/create-token.d.ts

@@ -0,0 +1,10 @@
+export interface CreateTokenOptions {
+    name: string;
+    symbol: string;
+    decimals: string;
+    supply?: string;
+    keypair?: string;
+    rpc?: string;
+}
+export declare function cmdCreateToken(opts: CreateTokenOptions): Promise<void>;
+//# sourceMappingURL=create-token.d.ts.map

package/dist/commands/create-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-token.d.ts","sourceRoot":"","sources":["../../src/commands/create-token.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,iBAqG5D"}

package/dist/commands/create-token.js

@@ -0,0 +1,91 @@
+import { Connection, LAMPORTS_PER_SOL, clusterApiUrl, } from "@solana/web3.js";
+import { createMint, getOrCreateAssociatedTokenAccount, mintTo, getMint, } from "@solana/spl-token";
+import { loadKeypair } from "../lib/keypair.js";
+import { header, success, info, error, warn, label, divider } from "../lib/logger.js";
+import ora from "ora";
+export async function cmdCreateToken(opts) {
+    header();
+    const decimals = parseInt(opts.decimals, 10);
+    if (isNaN(decimals) || decimals < 0 || decimals > 18) {
+        error("Decimals must be between 0 and 18");
+        process.exit(1);
+    }
+    const supply = opts.supply ? parseFloat(opts.supply) : 0;
+    let payer;
+    try {
+        payer = loadKeypair(opts.keypair);
+    }
+    catch (e) {
+        error(e.message);
+        process.exit(1);
+    }
+    const rpcUrl = opts.rpc ?? clusterApiUrl("devnet");
+    const connection = new Connection(rpcUrl, "confirmed");
+    // Check balance
+    const balance = await connection.getBalance(payer.publicKey);
+    if (balance < 0.01 * LAMPORTS_PER_SOL) {
+        error(`Insufficient SOL balance: ${(balance / LAMPORTS_PER_SOL).toFixed(4)} SOL`);
+        warn('Run: persolator airdrop --amount 2');
+        process.exit(1);
+    }
+    info(`Creating SPL token on Solana devnet...`);
+    info(`  Name:     ${opts.name}`);
+    info(`  Symbol:   ${opts.symbol}`);
+    info(`  Decimals: ${decimals}`);
+    if (supply > 0)
+        info(`  Supply:   ${supply.toLocaleString()} tokens`);
+    console.log("");
+    // 1. Create mint
+    const spinner = ora({ text: "Creating mint account...", color: "magenta" }).start();
+    let mint;
+    try {
+        mint = await createMint(connection, payer, payer.publicKey, payer.publicKey, decimals);
+        spinner.succeed(`Mint created: ${mint.toBase58()}`);
+    }
+    catch (e) {
+        spinner.fail("Failed to create mint");
+        error(e.message ?? String(e));
+        process.exit(1);
+    }
+    // 2. Optional: mint initial supply
+    let ataAddress;
+    if (supply > 0) {
+        const spinner2 = ora({ text: "Creating token account & minting supply...", color: "cyan" }).start();
+        try {
+            const ata = await getOrCreateAssociatedTokenAccount(connection, payer, mint, payer.publicKey);
+            const amount = BigInt(Math.round(supply * Math.pow(10, decimals)));
+            await mintTo(connection, payer, mint, ata.address, payer, amount);
+            ataAddress = ata.address.toBase58();
+            spinner2.succeed(`Minted ${supply.toLocaleString()} ${opts.symbol} to your wallet`);
+        }
+        catch (e) {
+            spinner2.warn("Supply minting failed (token was still created)");
+            warn(e.message ?? String(e));
+        }
+    }
+    // 3. Verify
+    const mintInfo = await getMint(connection, mint);
+    console.log("");
+    divider();
+    info("Token Created Successfully");
+    divider();
+    label("Name", opts.name);
+    label("Symbol", opts.symbol);
+    label("Mint Address", mint.toBase58());
+    label("Decimals", mintInfo.decimals.toString());
+    label("Authority", mintInfo.mintAuthority?.toBase58() ?? "none");
+    if (ataAddress) {
+        label("Token Account", ataAddress);
+        label("Supply", `${supply.toLocaleString()} ${opts.symbol}`);
+    }
+    label("Explorer", `https://explorer.solana.com/address/${mint.toBase58()}?cluster=devnet`);
+    divider();
+    console.log("");
+    success("Mint address ready to use on Persolator!");
+    console.log("");
+    info("Next step — launch a perpetual market on Persolator:");
+    info(`  https://persolator.xyz/launch`);
+    info(`  Paste this mint address: ${mint.toBase58()}`);
+    console.log("");
+}
+//# sourceMappingURL=create-token.js.map

package/dist/commands/create-token.js.map

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

package/dist/commands/markets.d.ts

@@ -0,0 +1,5 @@
+export interface MarketsOptions {
+    api?: string;
+}
+export declare function cmdMarkets(opts: MarketsOptions): Promise<void>;
+//# sourceMappingURL=markets.d.ts.map

package/dist/commands/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/commands/markets.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,iBAsDpD"}

package/dist/commands/markets.js

@@ -0,0 +1,53 @@
+import { header, info, label, divider, error, success } from "../lib/logger.js";
+import chalk from "chalk";
+export async function cmdMarkets(opts) {
+    header();
+    const base = (opts.api ?? "https://api.persolator.xyz").replace(/\/$/, "");
+    const spinner = (await import("ora")).default({
+        text: `Fetching markets from ${base}...`,
+        color: "cyan",
+    }).start();
+    let markets;
+    try {
+        const res = await fetch(`${base}/api/markets`);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+        const data = await res.json();
+        markets = data.markets ?? [];
+        spinner.succeed(`Found ${markets.length} active market${markets.length !== 1 ? "s" : ""}`);
+    }
+    catch (e) {
+        spinner.fail("Failed to fetch markets");
+        error(e.message ?? String(e));
+        process.exit(1);
+    }
+    if (markets.length === 0) {
+        info("No markets found. Be the first to launch one!");
+        info("  persolator launch   (coming soon)");
+        info(`  https://persolator.xyz/launch`);
+        return;
+    }
+    console.log("");
+    divider();
+    info("Persolator Markets");
+    divider();
+    for (const m of markets) {
+        const change = m.priceChange24h ?? 0;
+        const color = change >= 0 ? chalk.hex("#22c55e") : chalk.hex("#ef4444");
+        const arrow = change >= 0 ? "↑" : "↓";
+        console.log("");
+        label("Market", m.symbol);
+        label("Price", `$${Number(m.price ?? 0).toFixed(4)}`);
+        label("24h", color(`${arrow} ${Math.abs(change).toFixed(2)}%`));
+        label("Volume", `$${Number(m.volume24h ?? 0).toLocaleString()}`);
+        label("Open Int.", `$${Number(m.openInterest ?? 0).toLocaleString()}`);
+        label("Max Lev", `${m.maxLeverage ?? "—"}x`);
+        label("Creator", m.creatorWallet ? `${m.creatorWallet.slice(0, 8)}...` : "—");
+    }
+    console.log("");
+    divider();
+    console.log("");
+    success(`Trade at https://persolator.xyz/markets`);
+    console.log("");
+}
+//# sourceMappingURL=markets.js.map

package/dist/commands/markets.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { cmdCreateToken } from "./commands/create-token.js";
+import { cmdAirdrop } from "./commands/airdrop.js";
+import { cmdMarkets } from "./commands/markets.js";
+const program = new Command();
+program
+    .name("persolator")
+    .description("Official CLI for Persolator — permissionless perpetual futures on Solana")
+    .version("0.1.0");
+// ── create-token ──────────────────────────────────────────────────────────────
+program
+    .command("create-token")
+    .description("Create a new SPL token on Solana devnet (ready to use as a Persolator market)")
+    .requiredOption("-n, --name <name>", "Token name  (e.g. \"My Test Token\")")
+    .requiredOption("-s, --symbol <symbol>", "Token symbol (e.g. MTT)")
+    .option("-d, --decimals <n>", "Token decimals", "9")
+    .option("--supply <amount>", "Initial supply to mint to your wallet (optional)")
+    .option("-k, --keypair <path>", "Path to Solana keypair JSON file")
+    .option("--rpc <url>", "Custom Solana RPC endpoint (default: devnet)")
+    .action(cmdCreateToken);
+// ── airdrop ───────────────────────────────────────────────────────────────────
+program
+    .command("airdrop")
+    .description("Request a devnet SOL airdrop (max 5 SOL per request)")
+    .option("-a, --amount <sol>", "Amount of SOL to request", "2")
+    .option("-k, --keypair <path>", "Path to Solana keypair JSON file")
+    .option("--rpc <url>", "Custom Solana RPC endpoint (default: devnet)")
+    .action(cmdAirdrop);
+// ── markets ───────────────────────────────────────────────────────────────────
+program
+    .command("markets")
+    .description("List all active Persolator markets")
+    .option("--api <url>", "Persolator API base URL", "https://api.persolator.xyz")
+    .action(cmdMarkets);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAU,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAU,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,0EAA0E,CAAC;KACvF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,+EAA+E,CAAC;KAC5F,cAAc,CAAC,mBAAmB,EAAU,sCAAsC,CAAC;KACnF,cAAc,CAAC,uBAAuB,EAAM,yBAAyB,CAAC;KACtE,MAAM,CAAC,oBAAoB,EAAiB,gBAAgB,EAAE,GAAG,CAAC;KAClE,MAAM,CAAC,mBAAmB,EAAkB,kDAAkD,CAAC;KAC/F,MAAM,CAAC,sBAAsB,EAAe,kCAAkC,CAAC;KAC/E,MAAM,CAAC,aAAa,EAAwB,8CAA8C,CAAC;KAC3F,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,oBAAoB,EAAiB,0BAA0B,EAAE,GAAG,CAAC;KAC5E,MAAM,CAAC,sBAAsB,EAAe,kCAAkC,CAAC;KAC/E,MAAM,CAAC,aAAa,EAAwB,8CAA8C,CAAC;KAC3F,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,iFAAiF;AAEjF,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,aAAa,EAAwB,yBAAyB,EAAE,4BAA4B,CAAC;KACpG,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/keypair.d.ts

@@ -0,0 +1,4 @@
+import { Keypair } from "@solana/web3.js";
+export declare function loadKeypair(filePath?: string): Keypair;
+export declare function keypairPath(filePath?: string): string;
+//# sourceMappingURL=keypair.d.ts.map

package/dist/lib/keypair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../../src/lib/keypair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK1C,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAoBtD;AAED,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/lib/keypair.js

@@ -0,0 +1,29 @@
+import { Keypair } from "@solana/web3.js";
+import { readFileSync, existsSync } from "fs";
+import { resolve, join } from "path";
+import { homedir } from "os";
+export function loadKeypair(filePath) {
+    const paths = [
+        filePath && resolve(filePath),
+        process.env.SOLANA_KEYPAIR,
+        join(homedir(), ".config", "solana", "id.json"),
+    ].filter(Boolean);
+    for (const p of paths) {
+        if (existsSync(p)) {
+            const raw = readFileSync(p, "utf8");
+            const arr = JSON.parse(raw);
+            return Keypair.fromSecretKey(Uint8Array.from(arr));
+        }
+    }
+    throw new Error("No keypair found.\n" +
+        "  Generate one:  solana-keygen new\n" +
+        "  Or pass:       --keypair /path/to/id.json");
+}
+export function keypairPath(filePath) {
+    if (filePath)
+        return resolve(filePath);
+    if (process.env.SOLANA_KEYPAIR)
+        return process.env.SOLANA_KEYPAIR;
+    return join(homedir(), ".config", "solana", "id.json");
+}
+//# sourceMappingURL=keypair.js.map

package/dist/lib/keypair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.js","sourceRoot":"","sources":["../../src/lib/keypair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,MAAM,KAAK,GAAG;QACZ,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;KAChD,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;YACxC,OAAO,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qBAAqB;QACrB,sCAAsC;QACtC,6CAA6C,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,8 @@
+export declare function header(): void;
+export declare function success(msg: string): void;
+export declare function info(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function error(msg: string): void;
+export declare function label(key: string, value: string): void;
+export declare function divider(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAKA,wBAAgB,MAAM,SAKrB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,QAElC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,QAE/B;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,QAE/B;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,QAEhC;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAE/C;AAED,wBAAgB,OAAO,SAEtB"}

package/dist/lib/logger.js

@@ -0,0 +1,28 @@
+import chalk from "chalk";
+const BRAND = chalk.hex("#e040fb").bold("PERSOLATOR");
+const SEP = chalk.white.dim("·");
+export function header() {
+    console.log("");
+    console.log(`  ${BRAND} ${SEP} ${chalk.hex("#22d3ee")("CLI")} ${SEP} ${chalk.hex("#00ff88").dim("Solana Devnet Tooling")}`);
+    console.log(`  ${chalk.dim("https://persolator.xyz")}`);
+    console.log("");
+}
+export function success(msg) {
+    console.log(`  ${chalk.hex("#00ff88")("✓")} ${msg}`);
+}
+export function info(msg) {
+    console.log(`  ${chalk.hex("#22d3ee")("→")} ${msg}`);
+}
+export function warn(msg) {
+    console.log(`  ${chalk.yellow("!")} ${chalk.yellow(msg)}`);
+}
+export function error(msg) {
+    console.log(`  ${chalk.red("✗")} ${chalk.red(msg)}`);
+}
+export function label(key, value) {
+    console.log(`    ${chalk.dim(key.padEnd(20))} ${chalk.white(value)}`);
+}
+export function divider() {
+    console.log(`  ${chalk.dim("─".repeat(52))}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACtD,MAAM,GAAG,GAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC5H,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,KAAa;IAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "persolator-cli",
+  "version": "0.1.0",
+  "description": "Official CLI for Persolator — create SPL tokens on Solana devnet, manage markets, and interact with the Persolator perpetual futures protocol",
+  "keywords": [
+    "persolator",
+    "solana",
+    "spl-token",
+    "devnet",
+    "perpetual",
+    "defi",
+    "cli"
+  ],
+  "author": "Persolator <dev@persolator.xyz> (https://persolator.xyz)",
+  "license": "MIT",
+  "homepage": "https://persolator.xyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/persolator/persolator-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/persolator/persolator-cli/issues"
+  },
+  "type": "module",
+  "bin": {
+    "persolator": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json && node scripts/postbuild.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "pnpm build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@solana/spl-token": "^0.4.13",
+    "@solana/web3.js": "^1.98.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}