@magicblock-console/core 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,98 @@
+import type { ClientOptions, CommitOptions, CommitResult, ConfigureProjectOptions, CostBreakdown, Crank, CrankCreateOptions, CreateProjectOptions, DelegateOptions, DelegatedAccount, DelegationResult, DelegationStatus, LogEntry, Network, PriceFeed, PriceFeedOptions, PrivacyDepositOptions, PrivacyResult, PrivacyTransferOptions, PrivacyWithdrawOptions, Project, ProjectStatus, StateDiff, UndelegateOptions, VrfRequestOptions, VrfResult } from './types.js';
+import { type Storage } from './storage.js';
+import type { SolanaSignerAdapter } from './connection.js';
+export interface ProjectsNamespace {
+    create(options: CreateProjectOptions): Promise<Project>;
+    get(name: string): Promise<Project>;
+    list(): Promise<Project[]>;
+    configure(name: string, options: ConfigureProjectOptions): Promise<Project>;
+    delete(name: string): Promise<void>;
+}
+export interface ErNamespace {
+    delegate(options: DelegateOptions): Promise<DelegationResult>;
+    undelegate(options: UndelegateOptions): Promise<DelegationResult>;
+    commit(options: CommitOptions): Promise<CommitResult>;
+    status(account: string): Promise<DelegationStatus>;
+    accounts(project: string): Promise<DelegatedAccount[]>;
+    diff(account: string): Promise<StateDiff>;
+}
+export interface VrfNamespace {
+    request(options: VrfRequestOptions): Promise<VrfResult>;
+}
+export interface PrivacyNamespace {
+    deposit(options: PrivacyDepositOptions): Promise<PrivacyResult>;
+    transfer(options: PrivacyTransferOptions): Promise<PrivacyResult>;
+    withdraw(options: PrivacyWithdrawOptions): Promise<PrivacyResult>;
+}
+export interface CranksNamespace {
+    create(options: CrankCreateOptions): Promise<Crank>;
+    list(project: string): Promise<Crank[]>;
+    stop(crankId: string): Promise<Crank>;
+}
+export interface OracleNamespace {
+    getPrice(options: PriceFeedOptions): Promise<PriceFeed>;
+}
+export interface MonitorNamespace {
+    status(project: string): Promise<ProjectStatus>;
+    costs(project: string, period?: string): Promise<CostBreakdown>;
+    logs(project: string, limit?: number): Promise<LogEntry[]>;
+}
+export interface NamespaceOverrides {
+    projects?: ProjectsNamespace;
+    er?: ErNamespace;
+    vrf?: VrfNamespace;
+    privacy?: PrivacyNamespace;
+    cranks?: CranksNamespace;
+    oracle?: OracleNamespace;
+    monitor?: MonitorNamespace;
+}
+export declare class ConsoleClient {
+    readonly network: Network;
+    readonly storage: Storage;
+    readonly projects: ProjectsNamespace;
+    readonly er: ErNamespace;
+    readonly vrf: VrfNamespace;
+    readonly privacy: PrivacyNamespace;
+    readonly cranks: CranksNamespace;
+    readonly oracle: OracleNamespace;
+    readonly monitor: MonitorNamespace;
+    private _connection?;
+    constructor(options?: ClientOptions, namespaces?: NamespaceOverrides);
+    /**
+     * Connect to Solana using a local keypair file.
+     * Enables real on-chain transactions for ER operations.
+     * Typically used by CLI and MCP server.
+     *
+     * Connection module is loaded dynamically to avoid pulling Node.js-only
+     * dependencies (@solana/web3.js, MagicBlock SDK) into browser bundles.
+     */
+    connectWithKeypair(keypairPath: string): Promise<void>;
+    /**
+     * Connect in read-only mode (no signer).
+     * Enables querying real on-chain data (status, diff) without
+     * the ability to send transactions.
+     *
+     * Note: requires Node.js environment (uses @solana/web3.js Connection).
+     */
+    connectReadOnly(): Promise<void>;
+    /** Returns true if a blockchain connection is active. */
+    get isConnected(): boolean;
+    /**
+     * Connect using a browser wallet adapter (e.g. Phantom).
+     * The signer must provide `publicKey` and `signTransaction`.
+     *
+     * Connection module is loaded dynamically to avoid pulling Node.js-only
+     * dependencies into browser bundles.
+     */
+    connectWithSigner(signer: SolanaSignerAdapter): Promise<void>;
+    /**
+     * Disconnect from the blockchain.
+     * Namespaces automatically fall back to simulated mode.
+     */
+    disconnect(): void;
+    /** Returns true if the connection has a signer (can send transactions). */
+    get canSign(): boolean;
+}
+/** Create a new ConsoleClient instance. */
+export declare function createClient(options?: ClientOptions, namespaces?: NamespaceOverrides): ConsoleClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,96 @@
+import { MemoryStorage } from './storage.js';
+import { createProjectsNamespace } from './projects.js';
+import { createErNamespace } from './er.js';
+import { createVrfNamespace } from './vrf.js';
+import { createPrivacyNamespace } from './privacy.js';
+import { createCranksNamespace } from './cranks.js';
+import { createOracleNamespace } from './oracle.js';
+import { createMonitorNamespace } from './monitor.js';
+// ---------------------------------------------------------------------------
+// ConsoleClient
+// ---------------------------------------------------------------------------
+export class ConsoleClient {
+    network;
+    storage;
+    projects;
+    er;
+    vrf;
+    privacy;
+    cranks;
+    oracle;
+    monitor;
+    _connection;
+    constructor(options = {}, namespaces = {}) {
+        this.network = options.network ?? 'devnet';
+        this.storage = options.storage ?? new MemoryStorage();
+        // Wire real implementations with stub fallbacks
+        this.projects = namespaces.projects ?? createProjectsNamespace(this.storage);
+        this.er = namespaces.er ?? createErNamespace(this.storage, this.network, async (project) => {
+            const p = await this.projects.get(project);
+            return p.region;
+        }, () => this._connection);
+        this.vrf = namespaces.vrf ?? createVrfNamespace(this.storage, this.network);
+        this.privacy = namespaces.privacy ?? createPrivacyNamespace(this.storage, this.network, () => this._connection);
+        this.cranks = namespaces.cranks ?? createCranksNamespace(this.storage, this.network, () => this._connection);
+        this.oracle = namespaces.oracle ?? createOracleNamespace(this.storage, this.network, () => this._connection);
+        this.monitor = namespaces.monitor ?? createMonitorNamespace(this.storage, this.network);
+    }
+    /**
+     * Connect to Solana using a local keypair file.
+     * Enables real on-chain transactions for ER operations.
+     * Typically used by CLI and MCP server.
+     *
+     * Connection module is loaded dynamically to avoid pulling Node.js-only
+     * dependencies (@solana/web3.js, MagicBlock SDK) into browser bundles.
+     */
+    async connectWithKeypair(keypairPath) {
+        const { createKeypairSigner, createBlockchainConnection } = await import('./connection.js');
+        const signer = await createKeypairSigner(keypairPath);
+        this._connection = createBlockchainConnection(this.network, signer);
+    }
+    /**
+     * Connect in read-only mode (no signer).
+     * Enables querying real on-chain data (status, diff) without
+     * the ability to send transactions.
+     *
+     * Note: requires Node.js environment (uses @solana/web3.js Connection).
+     */
+    async connectReadOnly() {
+        const { createReadOnlyConnection } = await import('./connection.js');
+        this._connection = createReadOnlyConnection(this.network);
+    }
+    /** Returns true if a blockchain connection is active. */
+    get isConnected() {
+        return this._connection !== undefined;
+    }
+    /**
+     * Connect using a browser wallet adapter (e.g. Phantom).
+     * The signer must provide `publicKey` and `signTransaction`.
+     *
+     * Connection module is loaded dynamically to avoid pulling Node.js-only
+     * dependencies into browser bundles.
+     */
+    async connectWithSigner(signer) {
+        const { createBlockchainConnection } = await import('./connection.js');
+        this._connection = createBlockchainConnection(this.network, signer);
+    }
+    /**
+     * Disconnect from the blockchain.
+     * Namespaces automatically fall back to simulated mode.
+     */
+    disconnect() {
+        this._connection = undefined;
+    }
+    /** Returns true if the connection has a signer (can send transactions). */
+    get canSign() {
+        return this._connection?.signer !== undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/** Create a new ConsoleClient instance. */
+export function createClient(options = {}, namespaces = {}) {
+    return new ConsoleClient(options, namespaces);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,41 @@
+import type { FeatureFlags, Network, Region } from './types.js';
+export interface RegionEndpoints {
+    http: string;
+    ws: string;
+}
+export interface RegionConfig {
+    devnet: RegionEndpoints;
+    mainnet: RegionEndpoints;
+}
+export declare const REGIONS: Record<Region, RegionConfig>;
+export declare const PROGRAM_IDS: {
+    readonly delegation: "DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh";
+    readonly magic: "Magic11111111111111111111111111111111111111";
+    readonly magicContext: "MagicContext1111111111111111111111111111111";
+    readonly permission: "ACLseoPoyC3cBqoUtkbjZ4aDrkurZW86v19pXz2XQnp1";
+    readonly ephemeralSplToken: "SPLxh1LVZzEkX99H6rqYizhytLWPZVV296zyYDPagv2";
+    readonly pythReceiver: "rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ";
+};
+export interface ValidatorSet {
+    us: string;
+    eu: string;
+    asia: string;
+    tee: string;
+}
+/**
+ * ER validator pubkeys per network and region.
+ * NOTE: Mainnet keys currently mirror devnet — MagicBlock has not yet
+ * published separate mainnet validator identities.
+ */
+export declare const VALIDATORS: Record<Network, ValidatorSet>;
+export interface RouterEndpoints {
+    http: string;
+    ws: string;
+}
+export declare const MAGIC_ROUTER: Record<Network, RouterEndpoints>;
+export declare const DEFAULT_FEATURES: FeatureFlags;
+/** Resolve region-specific endpoints for a given network. */
+export declare function getRegionConfig(region: Region, network: Network): RegionEndpoints;
+/** Resolve Magic Router endpoints for a given network. */
+export declare function getMagicRouterEndpoints(network: Network): RouterEndpoints;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMhE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+BhD,CAAC;AAMF,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAapD,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,CASzD,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,YAM9B,CAAC;AAMF,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAEjF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAEzE"}

package/dist/config.js

@@ -0,0 +1,94 @@
+export const REGIONS = {
+    us: {
+        devnet: {
+            http: 'https://devnet-us.magicblock.app',
+            ws: 'wss://devnet-us.magicblock.app',
+        },
+        mainnet: {
+            http: 'https://us.magicblock.app',
+            ws: 'wss://us.magicblock.app',
+        },
+    },
+    eu: {
+        devnet: {
+            http: 'https://devnet-eu.magicblock.app',
+            ws: 'wss://devnet-eu.magicblock.app',
+        },
+        mainnet: {
+            http: 'https://eu.magicblock.app',
+            ws: 'wss://eu.magicblock.app',
+        },
+    },
+    asia: {
+        devnet: {
+            http: 'https://devnet-as.magicblock.app',
+            ws: 'wss://devnet-as.magicblock.app',
+        },
+        mainnet: {
+            http: 'https://as.magicblock.app',
+            ws: 'wss://as.magicblock.app',
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Program IDs
+// ---------------------------------------------------------------------------
+export const PROGRAM_IDS = {
+    delegation: 'DELeGGvXpWV2fqJUhqcF5ZSYMS4JTLjteaAMARRSaeSh',
+    magic: 'Magic11111111111111111111111111111111111111',
+    magicContext: 'MagicContext1111111111111111111111111111111',
+    permission: 'ACLseoPoyC3cBqoUtkbjZ4aDrkurZW86v19pXz2XQnp1',
+    ephemeralSplToken: 'SPLxh1LVZzEkX99H6rqYizhytLWPZVV296zyYDPagv2',
+    pythReceiver: 'rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ',
+};
+/**
+ * ER validator pubkeys per network and region.
+ * NOTE: Mainnet keys currently mirror devnet — MagicBlock has not yet
+ * published separate mainnet validator identities.
+ */
+export const VALIDATORS = {
+    devnet: {
+        us: 'MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd',
+        eu: 'MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e',
+        asia: 'MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57',
+        tee: 'MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo',
+    },
+    mainnet: {
+        us: 'MUS3hc9TCw4cGC12vHNoYcCGzJG1txjgQLZWVoeNHNd',
+        eu: 'MEUGGrYPxKk17hCr7wpT6s8dtNokZj5U2L57vjYMS8e',
+        asia: 'MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57',
+        tee: 'MTEWGuqxUpYZGFJQcp8tLN7x5v9BSeoFHYWQQ3n3xzo',
+    },
+};
+export const MAGIC_ROUTER = {
+    devnet: {
+        http: 'https://devnet-router.magicblock.app',
+        ws: 'wss://devnet-router.magicblock.app',
+    },
+    mainnet: {
+        http: 'https://router.magicblock.app',
+        ws: 'wss://router.magicblock.app',
+    },
+};
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+export const DEFAULT_FEATURES = {
+    gasless: false,
+    privacy: false,
+    vrf: false,
+    cranks: false,
+    oracle: false,
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Resolve region-specific endpoints for a given network. */
+export function getRegionConfig(region, network) {
+    return REGIONS[region][network];
+}
+/** Resolve Magic Router endpoints for a given network. */
+export function getMagicRouterEndpoints(network) {
+    return MAGIC_ROUTER[network];
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,EAAE,EAAE;QACF,MAAM,EAAE;YACN,IAAI,EAAE,kCAAkC;YACxC,EAAE,EAAE,gCAAgC;SACrC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,2BAA2B;YACjC,EAAE,EAAE,yBAAyB;SAC9B;KACF;IACD,EAAE,EAAE;QACF,MAAM,EAAE;YACN,IAAI,EAAE,kCAAkC;YACxC,EAAE,EAAE,gCAAgC;SACrC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,2BAA2B;YACjC,EAAE,EAAE,yBAAyB;SAC9B;KACF;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,kCAAkC;YACxC,EAAE,EAAE,gCAAgC;SACrC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,2BAA2B;YACjC,EAAE,EAAE,yBAAyB;SAC9B;KACF;CACF,CAAC;AAEF,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,8CAA8C;IAC1D,KAAK,EAAE,6CAA6C;IACpD,YAAY,EAAE,6CAA6C;IAC3D,UAAU,EAAE,8CAA8C;IAC1D,iBAAiB,EAAE,6CAA6C;IAChE,YAAY,EAAE,6CAA6C;CACnD,CAAC;AAaX;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkC;IACvD,MAAM,EAAE;QACN,EAAE,EAAE,6CAA6C;QACjD,EAAE,EAAE,6CAA6C;QACjD,IAAI,EAAE,6CAA6C;QACnD,GAAG,EAAE,6CAA6C;KACnD;IACD,OAAO,EAAE;QACP,EAAE,EAAE,6CAA6C;QACjD,EAAE,EAAE,6CAA6C;QACjD,IAAI,EAAE,6CAA6C;QACnD,GAAG,EAAE,6CAA6C;KACnD;CACF,CAAC;AAWF,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,MAAM,EAAE;QACN,IAAI,EAAE,sCAAsC;QAC5C,EAAE,EAAE,oCAAoC;KACzC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,+BAA+B;QACrC,EAAE,EAAE,6BAA6B;KAClC;CACF,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;IACd,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;CACd,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAgB;IAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/connection.d.ts

@@ -0,0 +1,42 @@
+import { Connection, PublicKey, Transaction } from '@solana/web3.js';
+import { ConnectionMagicRouter } from '@magicblock-labs/ephemeral-rollups-sdk';
+import type { Network } from './types.js';
+/**
+ * Adapter bridging a Solana Keypair (or wallet adapter) into a uniform
+ * signing interface used by the Console SDK.
+ */
+export interface SolanaSignerAdapter {
+    publicKey: PublicKey;
+    signTransaction(tx: Transaction): Promise<Transaction>;
+}
+/**
+ * Holds all the connections needed to interact with the Solana base layer,
+ * the Magic Router, and regional ER validators.
+ */
+export interface BlockchainConnection {
+    /** Standard Solana RPC connection (devnet / mainnet). */
+    baseConnection: Connection;
+    /** Magic Router connection for delegation routing. */
+    routerConnection: ConnectionMagicRouter;
+    /** Regional ER endpoint connections keyed by region id. */
+    erConnections: Record<string, Connection>;
+    /** Signer for building and sending transactions (undefined = read-only). */
+    signer?: SolanaSignerAdapter;
+    /** Active network. */
+    network: Network;
+}
+/**
+ * Create a `SolanaSignerAdapter` from a local keypair JSON file.
+ * The file should contain a JSON array of 64 bytes (Solana CLI format).
+ */
+export declare function createKeypairSigner(keypairPath: string): Promise<SolanaSignerAdapter>;
+/**
+ * Create a full `BlockchainConnection` with signer for sending transactions.
+ */
+export declare function createBlockchainConnection(network: Network, signer: SolanaSignerAdapter): BlockchainConnection;
+/**
+ * Create a read-only `BlockchainConnection` (no signer).
+ * Useful for querying delegation status and account data without signing.
+ */
+export declare function createReadOnlyConnection(network: Network): BlockchainConnection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,SAAS,EACT,WAAW,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAO1C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,cAAc,EAAE,UAAU,CAAC;IAC3B,sDAAsD;IACtD,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,4EAA4E;IAC5E,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAWD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,mBAAmB,GAC1B,oBAAoB,CAEtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GACf,oBAAoB,CAEtB"}

package/dist/connection.js

@@ -0,0 +1,82 @@
+import { Connection, Keypair, } from '@solana/web3.js';
+import { ConnectionMagicRouter } from '@magicblock-labs/ephemeral-rollups-sdk';
+import { MAGIC_ROUTER, REGIONS } from './config.js';
+// ---------------------------------------------------------------------------
+// Keypair Signer
+// ---------------------------------------------------------------------------
+/**
+ * Create a `SolanaSignerAdapter` from a local keypair JSON file.
+ * The file should contain a JSON array of 64 bytes (Solana CLI format).
+ */
+export async function createKeypairSigner(keypairPath) {
+    const fs = await import('node:fs/promises');
+    const path = await import('node:path');
+    const resolved = path.resolve(keypairPath);
+    if (!resolved.endsWith('.json')) {
+        throw new Error('Keypair file must be a .json file');
+    }
+    const raw = await fs.readFile(resolved, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('Invalid keypair file: must contain valid JSON');
+    }
+    if (!Array.isArray(parsed) ||
+        parsed.length !== 64 ||
+        !parsed.every((n) => typeof n === 'number' && n >= 0 && n <= 255)) {
+        throw new Error('Invalid keypair file: must contain a JSON array of 64 bytes');
+    }
+    const secretKey = Uint8Array.from(parsed);
+    const keypair = Keypair.fromSecretKey(secretKey);
+    // Zero out intermediate buffer
+    secretKey.fill(0);
+    return {
+        publicKey: keypair.publicKey,
+        async signTransaction(tx) {
+            tx.partialSign(keypair);
+            return tx;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Connection Factories
+// ---------------------------------------------------------------------------
+const SOLANA_RPC = {
+    devnet: 'https://api.devnet.solana.com',
+    mainnet: 'https://api.mainnet-beta.solana.com',
+};
+/**
+ * Create a full `BlockchainConnection` with signer for sending transactions.
+ */
+export function createBlockchainConnection(network, signer) {
+    return buildConnection(network, signer);
+}
+/**
+ * Create a read-only `BlockchainConnection` (no signer).
+ * Useful for querying delegation status and account data without signing.
+ */
+export function createReadOnlyConnection(network) {
+    return buildConnection(network);
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+function buildConnection(network, signer) {
+    const baseConnection = new Connection(SOLANA_RPC[network], 'confirmed');
+    const routerUrl = MAGIC_ROUTER[network].http;
+    const routerConnection = new ConnectionMagicRouter(routerUrl, 'confirmed');
+    const erConnections = {};
+    for (const [region, config] of Object.entries(REGIONS)) {
+        erConnections[region] = new Connection(config[network].http, 'confirmed');
+    }
+    return {
+        baseConnection,
+        routerConnection,
+        erConnections,
+        signer,
+        network,
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,GAGR,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAoCpD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB;IAEnB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACtB,MAAM,CAAC,MAAM,KAAK,EAAE;QACpB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EACjE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACjD,+BAA+B;IAC/B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAElB,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,CAAC,eAAe,CAAC,EAAe;YACnC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,GAA4B;IAC1C,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,qCAAqC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAgB,EAChB,MAA2B;IAE3B,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAgB;IAEhB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,SAAS,eAAe,CACtB,OAAgB,EAChB,MAA4B;IAE5B,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAExE,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAE3E,MAAM,aAAa,GAA+B,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,cAAc;QACd,gBAAgB;QAChB,aAAa;QACb,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/cranks.d.ts

@@ -0,0 +1,14 @@
+import type { Storage } from './storage.js';
+import type { Network } from './types.js';
+import type { CranksNamespace } from './client.js';
+import type { BlockchainConnection } from './connection.js';
+/**
+ * Create a fully-functional `CranksNamespace` backed by the given Storage.
+ *
+ * When a `getConnection` callback returns a valid `BlockchainConnection`
+ * with a signer, and the `account` option is provided, a real
+ * `createCommitInstruction` is sent to the ER validator.
+ * Otherwise, crank creation falls back to simulated behavior.
+ */
+export declare function createCranksNamespace(storage: Storage, _network: Network, getConnection?: () => BlockchainConnection | undefined): CranksNamespace;
+//# sourceMappingURL=cranks.d.ts.map

package/dist/cranks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cranks.d.ts","sourceRoot":"","sources":["../src/cranks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EACV,OAAO,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AA4C5D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,GACrD,eAAe,CAwHjB"}

package/dist/cranks.js

@@ -0,0 +1,128 @@
+import { generateBase58 } from './utils.js';
+// ---------------------------------------------------------------------------
+// Key helpers
+// ---------------------------------------------------------------------------
+const CRANK_PREFIX = 'crank:';
+const CRANK_INDEX_PREFIX = 'crank-index:';
+function crankKey(id) {
+    return `${CRANK_PREFIX}${id}`;
+}
+function crankIndexKey(project) {
+    return `${CRANK_INDEX_PREFIX}${project}`;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load a project from storage and validate that the cranks feature is enabled.
+ */
+async function requireCranksEnabled(storage, project) {
+    const data = await storage.get(`project:${project}`);
+    if (!data) {
+        throw new Error(`Project "${project}" not found`);
+    }
+    const parsed = JSON.parse(data);
+    if (!parsed.features.cranks) {
+        throw new Error(`Feature "cranks" is not enabled for project "${project}". ` +
+            `Enable it with: client.projects.configure("${project}", { features: { cranks: true } })`);
+    }
+    return parsed;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a fully-functional `CranksNamespace` backed by the given Storage.
+ *
+ * When a `getConnection` callback returns a valid `BlockchainConnection`
+ * with a signer, and the `account` option is provided, a real
+ * `createCommitInstruction` is sent to the ER validator.
+ * Otherwise, crank creation falls back to simulated behavior.
+ */
+export function createCranksNamespace(storage, _network, getConnection) {
+    // Helper: read the crank index for a project
+    async function getCrankIndex(project) {
+        const data = await storage.get(crankIndexKey(project));
+        return data ? JSON.parse(data) : [];
+    }
+    // Helper: write the crank index for a project
+    async function setCrankIndex(project, ids) {
+        await storage.set(crankIndexKey(project), JSON.stringify(ids));
+    }
+    return {
+        async create(options) {
+            await requireCranksEnabled(storage, options.project);
+            if (options.intervalMs <= 0) {
+                throw new Error('intervalMs must be greater than 0');
+            }
+            const id = `crank_${Date.now().toString(36)}_${generateBase58(6)}`;
+            let commitSignature;
+            let simulated = true;
+            // Real blockchain: send initial commit instruction
+            const conn = getConnection?.();
+            if (options.account && conn?.signer) {
+                try {
+                    const { PublicKey, Transaction } = await import('@solana/web3.js');
+                    const { createCommitInstruction } = await import('@magicblock-labs/ephemeral-rollups-sdk');
+                    const accountPk = new PublicKey(options.account);
+                    const ix = createCommitInstruction(conn.signer.publicKey, [accountPk]);
+                    const tx = new Transaction().add(ix);
+                    tx.feePayer = conn.signer.publicKey;
+                    // Commit is a base chain operation
+                    tx.recentBlockhash = (await conn.baseConnection.getLatestBlockhash()).blockhash;
+                    const signed = await conn.signer.signTransaction(tx);
+                    commitSignature = await conn.baseConnection.sendRawTransaction(signed.serialize());
+                    simulated = false;
+                }
+                catch (err) {
+                    console.debug(`[mb-console] Real crank commit failed, using simulated mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            const crank = {
+                id,
+                intervalMs: options.intervalMs,
+                iterations: options.iterations ?? 0,
+                executed: 0,
+                status: 'running',
+                account: options.account,
+                commitSignature,
+                simulated,
+            };
+            // Persist crank record
+            await storage.set(crankKey(id), JSON.stringify(crank));
+            // Update project crank index
+            const index = await getCrankIndex(options.project);
+            index.push(id);
+            await setCrankIndex(options.project, index);
+            return crank;
+        },
+        async list(project) {
+            const index = await getCrankIndex(project);
+            const cranks = [];
+            for (const id of index) {
+                const data = await storage.get(crankKey(id));
+                if (data) {
+                    cranks.push(JSON.parse(data));
+                }
+            }
+            return cranks;
+        },
+        async stop(crankId) {
+            const data = await storage.get(crankKey(crankId));
+            if (!data) {
+                throw new Error(`Crank "${crankId}" not found`);
+            }
+            const crank = JSON.parse(data);
+            if (crank.status === 'stopped') {
+                throw new Error(`Crank "${crankId}" is already stopped`);
+            }
+            if (crank.status === 'completed') {
+                throw new Error(`Crank "${crankId}" has already completed`);
+            }
+            crank.status = 'stopped';
+            await storage.set(crankKey(crankId), JSON.stringify(crank));
+            return crank;
+        },
+    };
+}
+//# sourceMappingURL=cranks.js.map

package/dist/cranks.js.map

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