@xona-labs/xpay 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @xona-labs/xpay — discovery + usage layer for agentic commerce.
+ *
+ * Quick start:
+ * ```ts
+ * import { createXPay, rawSolanaSigner } from "@xona-labs/xpay";
+ *
+ * const xpay = createXPay({
+ *   networks: ["solana", "base"],
+ *   signers: { solana: rawSolanaSigner(SECRET_KEY) },
+ * });
+ *
+ * const results = await xpay.discover({ query: "weather forecast" });
+ * const result  = await xpay.use(results[0]);
+ * ```
+ */
+import { type Wallet } from "./wallet/index.js";
+import { Guardrail, type GuardrailConfig } from "./guardrail/index.js";
+import { type LoadedProfile } from "./profile/index.js";
+import { type HistoryEntry, type HistoryOptions } from "./history/index.js";
+import { type TransferResult } from "./transfer/index.js";
+import type { DiscoverOptions, Resource, UseResult, Network, Signer } from "./types.js";
+export * from "./types.js";
+export * from "./signers/index.js";
+export * from "./tools/index.js";
+export * from "./profile/index.js";
+export * from "./history/index.js";
+export * from "./transfer/index.js";
+export { Guardrail } from "./guardrail/index.js";
+/**
+ * Direct access to the discovery layer for callers (e.g. server routes) that
+ * want catalog data without configuring signers.
+ */
+export { discover } from "./discover/index.js";
+export { fetchPayAIResources } from "./discover/payai.js";
+/** Options for {@link createXPay}. */
+export interface XPayOptions {
+    /**
+     * A loaded profile — derives `networks`, `signers`, and `guardrail` from
+     * the profile's keyfile and config. Mutually exclusive with the manual
+     * `networks` + `signers` shape below.
+     */
+    profile?: LoadedProfile;
+    /** Networks the wallet will track. First entry is the default for payments. */
+    networks?: Network[];
+    /** Signers keyed by network. At minimum, one signer must be provided. */
+    signers?: Partial<Record<Network, Signer>>;
+    /** Optional spending guardrail enforced before every {@link XPay.use} call. */
+    guardrail?: GuardrailConfig;
+    /** Override built-in catalog endpoints (for self-hosted facilitators / tests). */
+    catalogs?: Partial<Record<string, string>>;
+}
+/** The xPay client returned by {@link createXPay}. */
+export interface XPay {
+    wallet: Wallet;
+    guardrail: Guardrail;
+    /** Find paid services across configured catalogs. */
+    discover(opts?: DiscoverOptions): Promise<Resource[]>;
+    /** Call a specific resource — handles payment + retry. */
+    use(resource: Resource, opts?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<UseResult>;
+    /**
+     * Call any URL that supports x402 — even one not in the catalog. Probes the
+     * URL, follows the 402 challenge, settles, retries.
+     */
+    useByUrl(url: string, opts?: {
+        method?: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<UseResult>;
+    /** Search by intent, pick the top result, and call it. The thesis in one method. */
+    do(query: string, opts?: {
+        body?: unknown;
+    }): Promise<UseResult>;
+    /** Recent USDC activity across all configured networks (merged + sorted). */
+    history(opts?: HistoryOptions): Promise<HistoryEntry[]>;
+    /** Direct USDC transfer (no x402). Subject to the same guardrail. */
+    transfer(args: {
+        amount: number;
+        to: string;
+        network?: Network;
+        token?: "USDC";
+    }): Promise<TransferResult>;
+}
+/**
+ * Create an xPay client.
+ *
+ * This is the single entry point for builders. Everything else is exposed for
+ * advanced cases (custom signers, manual discovery, raw x402 calls).
+ */
+export declare function createXPay(options: XPayOptions): XPay;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,74 @@
+/**
+ * @xona-labs/xpay — discovery + usage layer for agentic commerce.
+ *
+ * Quick start:
+ * ```ts
+ * import { createXPay, rawSolanaSigner } from "@xona-labs/xpay";
+ *
+ * const xpay = createXPay({
+ *   networks: ["solana", "base"],
+ *   signers: { solana: rawSolanaSigner(SECRET_KEY) },
+ * });
+ *
+ * const results = await xpay.discover({ query: "weather forecast" });
+ * const result  = await xpay.use(results[0]);
+ * ```
+ */
+import { createWallet } from "./wallet/index.js";
+import { discover } from "./discover/index.js";
+import { use, useByUrl } from "./use/index.js";
+import { doIt } from "./do/index.js";
+import { Guardrail } from "./guardrail/index.js";
+import { signersFromProfile } from "./profile/index.js";
+import { getHistory } from "./history/index.js";
+import { transfer } from "./transfer/index.js";
+export * from "./types.js";
+export * from "./signers/index.js";
+export * from "./tools/index.js";
+export * from "./profile/index.js";
+export * from "./history/index.js";
+export * from "./transfer/index.js";
+export { Guardrail } from "./guardrail/index.js";
+/**
+ * Direct access to the discovery layer for callers (e.g. server routes) that
+ * want catalog data without configuring signers.
+ */
+export { discover } from "./discover/index.js";
+export { fetchPayAIResources } from "./discover/payai.js";
+/**
+ * Create an xPay client.
+ *
+ * This is the single entry point for builders. Everything else is exposed for
+ * advanced cases (custom signers, manual discovery, raw x402 calls).
+ */
+export function createXPay(options) {
+    // Resolve networks + signers from either the manual config or a profile.
+    let networks = options.networks;
+    let signers = options.signers;
+    let guardrailConfig = options.guardrail;
+    if (options.profile) {
+        networks ??= options.profile.config.networks;
+        signers ??= signersFromProfile(options.profile);
+        guardrailConfig ??= options.profile.config.guardrail;
+    }
+    if (!networks?.length) {
+        throw new Error("createXPay: at least one network must be configured (via `networks` or `profile`)");
+    }
+    if (!signers || Object.keys(signers).length === 0) {
+        throw new Error("createXPay: at least one signer must be provided (via `signers` or `profile`)");
+    }
+    const walletOpts = { networks, signers };
+    const wallet = createWallet(walletOpts);
+    const guardrail = new Guardrail(guardrailConfig);
+    return {
+        wallet,
+        guardrail,
+        discover: (opts) => discover({ ...opts, catalogs: options.catalogs }),
+        use: (resource, opts) => use({ resource, wallet, guardrail, ...opts }),
+        useByUrl: (url, opts) => useByUrl({ url, wallet, guardrail, ...opts }),
+        do: (query, opts) => doIt({ query, wallet, guardrail, ...opts }),
+        history: (opts) => getHistory(wallet, opts),
+        transfer: (args) => transfer({ ...args, wallet, guardrail }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/profile/derive.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Derive Solana + EVM keys from a single BIP-39 mnemonic.
+ *
+ * Paths follow standard wallets so users can recover in Phantom/Solflare
+ * (Solana) and MetaMask/Rabby (EVM) using the same seed:
+ *   - Solana: m/44'/501'/0'/0'        (Phantom default)
+ *   - EVM:    m/44'/60'/0'/0/0        (MetaMask default)
+ */
+import { Keypair } from "@solana/web3.js";
+import type { ProfileAddresses } from "./types.js";
+/** Generate a fresh 24-word mnemonic (256-bit entropy). */
+export declare function generateNewMnemonic(): string;
+/** Throws if `mnemonic` is not a valid BIP-39 phrase. */
+export declare function assertValidMnemonic(mnemonic: string): void;
+export interface DerivedKeys {
+    solana: {
+        keypair: Keypair;
+        secretKeyBase58: string;
+        address: string;
+    };
+    evm: {
+        privateKey: string;
+        address: string;
+    };
+}
+export declare function deriveKeysFromMnemonic(mnemonic: string): DerivedKeys;
+export declare function addressesFromMnemonic(mnemonic: string): ProfileAddresses;
+//# sourceMappingURL=derive.d.ts.map

package/dist/profile/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/profile/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,2DAA2D;AAC3D,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,GAAG,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAsBpE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAGxE"}

package/dist/profile/derive.js

@@ -0,0 +1,75 @@
+/**
+ * Derive Solana + EVM keys from a single BIP-39 mnemonic.
+ *
+ * Paths follow standard wallets so users can recover in Phantom/Solflare
+ * (Solana) and MetaMask/Rabby (EVM) using the same seed:
+ *   - Solana: m/44'/501'/0'/0'        (Phantom default)
+ *   - EVM:    m/44'/60'/0'/0/0        (MetaMask default)
+ */
+import { mnemonicToSeedSync, generateMnemonic, validateMnemonic } from "bip39";
+import { derivePath } from "ed25519-hd-key";
+import { Keypair } from "@solana/web3.js";
+import { HDNodeWallet, Mnemonic } from "ethers";
+const SOLANA_PATH = "m/44'/501'/0'/0'";
+const EVM_PATH = "m/44'/60'/0'/0/0";
+/** Generate a fresh 24-word mnemonic (256-bit entropy). */
+export function generateNewMnemonic() {
+    return generateMnemonic(256);
+}
+/** Throws if `mnemonic` is not a valid BIP-39 phrase. */
+export function assertValidMnemonic(mnemonic) {
+    if (!validateMnemonic(mnemonic)) {
+        throw new Error("Invalid BIP-39 mnemonic phrase");
+    }
+}
+export function deriveKeysFromMnemonic(mnemonic) {
+    assertValidMnemonic(mnemonic);
+    const seed = mnemonicToSeedSync(mnemonic);
+    // --- Solana ---
+    const solSeed = derivePath(SOLANA_PATH, seed.toString("hex")).key;
+    const solKeypair = Keypair.fromSeed(new Uint8Array(solSeed));
+    // --- EVM ---
+    const evmWallet = HDNodeWallet.fromMnemonic(Mnemonic.fromPhrase(mnemonic), EVM_PATH);
+    return {
+        solana: {
+            keypair: solKeypair,
+            secretKeyBase58: base58Encode(solKeypair.secretKey),
+            address: solKeypair.publicKey.toBase58(),
+        },
+        evm: {
+            privateKey: evmWallet.privateKey,
+            address: evmWallet.address,
+        },
+    };
+}
+export function addressesFromMnemonic(mnemonic) {
+    const k = deriveKeysFromMnemonic(mnemonic);
+    return { solana: k.solana.address, evm: k.evm.address };
+}
+/** Tiny Base58 encoder (avoids adding bs58 just for this). */
+function base58Encode(bytes) {
+    const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+    if (bytes.length === 0)
+        return "";
+    const digits = [0];
+    for (let i = 0; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = 0; j < digits.length; j++) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = (carry / 58) | 0;
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = (carry / 58) | 0;
+        }
+    }
+    // Preserve leading zero bytes as leading '1's.
+    let out = "";
+    for (let i = 0; i < bytes.length && bytes[i] === 0; i++)
+        out += "1";
+    for (let i = digits.length - 1; i >= 0; i--)
+        out += ALPHABET[digits[i]];
+    return out;
+}
+//# sourceMappingURL=derive.js.map

package/dist/profile/derive.js.map

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

package/dist/profile/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Profile API — public SDK surface for keyfile management.
+ *
+ * Programmatic usage:
+ * ```ts
+ * import { initProfile, loadProfile, listProfiles } from "@xona-labs/xpay";
+ *
+ * const created = await initProfile({ name: "default", passphrase: "..." });
+ * console.log(created.mnemonic);             // back this up!
+ * console.log(created.addresses);            // { solana, evm }
+ *
+ * const p = await loadProfile({ name: "default", passphrase: "..." });
+ * // → can be fed directly to createXPay({ profile: p })
+ * ```
+ *
+ * CLI usage is a thin wrapper around these functions.
+ */
+import type { LoadedProfile, ProfileConfig, WalletFile } from "./types.js";
+import type { Signer } from "../types.js";
+export * from "./types.js";
+export { generateNewMnemonic, addressesFromMnemonic } from "./derive.js";
+export { xpayHome, workspaceXpayDir, listProfiles } from "./storage.js";
+export interface InitProfileOptions {
+    /** Profile name, defaults to "default". */
+    name?: string;
+    /** Use existing mnemonic (import) instead of generating one. */
+    mnemonic?: string;
+    /** Encrypt at rest. Strongly recommended — omit only for ephemeral dev wallets. */
+    passphrase?: string;
+    /** Use workspace-local `.xpay/` instead of `~/.xpay/`. */
+    workspace?: boolean | string;
+    /** Overwrite an existing profile with the same name. Default false. */
+    overwrite?: boolean;
+    /** Override initial config (defaults to Solana + Base). */
+    config?: Partial<ProfileConfig>;
+}
+export interface InitProfileResult {
+    name: string;
+    path: string;
+    addresses: WalletFile["addresses"];
+    /** Returned once at creation so the caller can show/save it. Never persisted in plaintext when a passphrase is set. */
+    mnemonic: string;
+    encrypted: boolean;
+}
+export declare function initProfile(opts?: InitProfileOptions): Promise<InitProfileResult>;
+export interface LoadProfileOptions {
+    name?: string;
+    passphrase?: string;
+    workspace?: boolean | string;
+}
+export declare function loadProfile(opts?: LoadProfileOptions): Promise<LoadedProfile>;
+/**
+ * Build runtime signers for every network in the profile's config. Used by
+ * createXPay when called with `{ profile }`.
+ */
+export declare function signersFromProfile(profile: LoadedProfile): Partial<Record<string, Signer>>;
+/**
+ * Update a profile's guardrail on disk. Merges with any existing guardrail
+ * (pass undefined to a field to leave it alone; pass null to clear it).
+ */
+export declare function setProfileGuardrail(name: string, guardrail: NonNullable<ProfileConfig["guardrail"]>, opts?: {
+    workspace?: boolean | string;
+}): ProfileConfig;
+/** Drop the guardrail entirely (calls now run unconstrained). */
+export declare function clearProfileGuardrail(name: string, opts?: {
+    workspace?: boolean | string;
+}): ProfileConfig;
+/** Read the on-disk config (guardrail, networks, link, etc.) for a profile. */
+export declare function readProfileConfig(name: string, opts?: {
+    workspace?: boolean | string;
+}): ProfileConfig;
+export { profilePath, profileExists } from "./storage.js";
+export { deriveKeysFromMnemonic } from "./derive.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profile/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMxE,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,uHAAuH;IACvH,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmB3F;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAYvF;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkB1F;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EAClD,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAC1C,aAAa,CAMf;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAC1C,aAAa,CAMf;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAC1C,aAAa,CAEf;AAMD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/profile/index.js

@@ -0,0 +1,115 @@
+/**
+ * Profile API — public SDK surface for keyfile management.
+ *
+ * Programmatic usage:
+ * ```ts
+ * import { initProfile, loadProfile, listProfiles } from "@xona-labs/xpay";
+ *
+ * const created = await initProfile({ name: "default", passphrase: "..." });
+ * console.log(created.mnemonic);             // back this up!
+ * console.log(created.addresses);            // { solana, evm }
+ *
+ * const p = await loadProfile({ name: "default", passphrase: "..." });
+ * // → can be fed directly to createXPay({ profile: p })
+ * ```
+ *
+ * CLI usage is a thin wrapper around these functions.
+ */
+import { addressesFromMnemonic, generateNewMnemonic, deriveKeysFromMnemonic } from "./derive.js";
+import { buildWalletFile, defaultConfig, profileExists, profilePath, readConfigFile, readWalletFile, unlockWalletFile, writeConfigFile, writeWalletFile, } from "./storage.js";
+import { rawSolanaSigner } from "../signers/raw-solana.js";
+import { rawEvmSigner } from "../signers/raw-evm.js";
+export * from "./types.js";
+export { generateNewMnemonic, addressesFromMnemonic } from "./derive.js";
+export { xpayHome, workspaceXpayDir, listProfiles } from "./storage.js";
+export async function initProfile(opts = {}) {
+    const name = opts.name ?? "default";
+    if (!opts.overwrite && profileExists(name, { workspace: opts.workspace })) {
+        throw new Error(`Profile "${name}" already exists. Pass { overwrite: true } to replace it.`);
+    }
+    const mnemonic = opts.mnemonic ?? generateNewMnemonic();
+    const addresses = addressesFromMnemonic(mnemonic);
+    const wallet = buildWalletFile({ mnemonic, addresses, passphrase: opts.passphrase });
+    const dir = profilePath(name, { workspace: opts.workspace });
+    writeWalletFile(dir, wallet);
+    writeConfigFile(dir, { ...defaultConfig(), ...opts.config });
+    return {
+        name,
+        path: dir,
+        addresses,
+        mnemonic,
+        encrypted: Boolean(opts.passphrase),
+    };
+}
+export async function loadProfile(opts = {}) {
+    const name = opts.name ?? "default";
+    const dir = profilePath(name, { workspace: opts.workspace });
+    const wallet = readWalletFile(dir);
+    const mnemonic = unlockWalletFile(wallet, opts.passphrase);
+    return {
+        name,
+        path: dir,
+        addresses: wallet.addresses,
+        config: readConfigFile(dir),
+        mnemonic,
+    };
+}
+// -----------------------------------------------------------------------------
+// signers from profile
+// -----------------------------------------------------------------------------
+/**
+ * Build runtime signers for every network in the profile's config. Used by
+ * createXPay when called with `{ profile }`.
+ */
+export function signersFromProfile(profile) {
+    const keys = deriveKeysFromMnemonic(profile.mnemonic);
+    const out = {};
+    for (const network of profile.config.networks) {
+        if (network === "solana") {
+            out.solana = rawSolanaSigner({
+                secretKey: keys.solana.keypair.secretKey,
+                rpcUrl: profile.config.rpcs?.solana,
+            });
+        }
+        else if (["base", "ethereum", "arbitrum", "optimism"].includes(network)) {
+            out[network] = rawEvmSigner({
+                privateKey: keys.evm.privateKey,
+                network,
+                rpcUrl: profile.config.rpcs?.[network],
+            });
+        }
+    }
+    return out;
+}
+// -----------------------------------------------------------------------------
+// Guardrail mutation
+// -----------------------------------------------------------------------------
+/**
+ * Update a profile's guardrail on disk. Merges with any existing guardrail
+ * (pass undefined to a field to leave it alone; pass null to clear it).
+ */
+export function setProfileGuardrail(name, guardrail, opts = {}) {
+    const dir = profilePath(name, opts);
+    const current = readConfigFile(dir);
+    current.guardrail = { ...current.guardrail, ...guardrail };
+    writeConfigFile(dir, current);
+    return current;
+}
+/** Drop the guardrail entirely (calls now run unconstrained). */
+export function clearProfileGuardrail(name, opts = {}) {
+    const dir = profilePath(name, opts);
+    const current = readConfigFile(dir);
+    delete current.guardrail;
+    writeConfigFile(dir, current);
+    return current;
+}
+/** Read the on-disk config (guardrail, networks, link, etc.) for a profile. */
+export function readProfileConfig(name, opts = {}) {
+    return readConfigFile(profilePath(name, opts));
+}
+// -----------------------------------------------------------------------------
+// re-export for convenience
+// -----------------------------------------------------------------------------
+export { profilePath, profileExists } from "./storage.js";
+export { deriveKeysFromMnemonic } from "./derive.js";
+//# sourceMappingURL=index.js.map

package/dist/profile/index.js.map

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

package/dist/profile/storage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Profile storage — read/write `wallet.json` + `config.json` under
+ * `~/.xpay/<name>/` (or a workspace path) with passphrase-based encryption.
+ *
+ * Encryption uses Node's built-in crypto (no new deps): scrypt → AES-256-GCM
+ * over the mnemonic. AES-GCM gives us authenticated encryption so we detect
+ * wrong passphrases / tampering instead of returning garbage.
+ */
+import type { ProfileConfig, WalletFile } from "./types.js";
+/** Root directory holding all profiles. Honors $XPAY_HOME. */
+export declare function xpayHome(): string;
+/** Workspace-local profile dir (when `--workspace` is passed). */
+export declare function workspaceXpayDir(cwd?: string): string;
+export declare function profilePath(name: string, opts?: {
+    workspace?: boolean | string;
+}): string;
+export declare function profileExists(name: string, opts?: {
+    workspace?: boolean | string;
+}): boolean;
+export declare function listProfiles(opts?: {
+    workspace?: boolean | string;
+}): string[];
+export declare function writeWalletFile(dir: string, wallet: WalletFile): void;
+export declare function readWalletFile(dir: string): WalletFile;
+export declare function writeConfigFile(dir: string, config: ProfileConfig): void;
+export declare function readConfigFile(dir: string): ProfileConfig;
+export declare function defaultConfig(): ProfileConfig;
+export interface BuildWalletInput {
+    mnemonic: string;
+    addresses: WalletFile["addresses"];
+    passphrase?: string;
+}
+export declare function buildWalletFile(input: BuildWalletInput): WalletFile;
+export declare function unlockWalletFile(wallet: WalletFile, passphrase?: string): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/profile/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/profile/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAO5D,8DAA8D;AAC9D,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,GAAG,SAAgB,GAAG,MAAM,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAAG,MAAM,CAO7F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAAG,OAAO,CAEhG;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GAAG,MAAM,EAAE,CAclF;AAqDD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,GACjB,IAAI,CAMN;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMtD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAGxE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIzD;AAED,wBAAgB,aAAa,IAAI,aAAa,CAM7C;AAUD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAYnE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhF"}