@4mica/sdk 1.2.0 → 1.2.2

package/dist/config.d.ts

@@ -41,8 +41,25 @@ export declare class ConfigBuilder {
     private _authEnabled;
     private _authUrl?;
     private _authRefreshMarginSecs?;
-    /** Override the 4Mica core RPC URL. Defaults to `https://api.4mica.xyz/`. */
+    /** Set the 4Mica core RPC URL directly. Use {@link network} to select a hosted network by name instead. Defaults to `https://ethereum.sepolia.api.4mica.xyz/`. */
     rpcUrl(value: string): ConfigBuilder;
+    /**
+     * Select a hosted 4Mica network by shorthand or CAIP-2 identifier.
+     * Resolves to the corresponding core API URL.
+     * Mutually exclusive with {@link rpcUrl} — last call wins.
+     *
+     * Supported values: `"base-sepolia"` / `"eip155:84532"`,
+     * `"ethereum-sepolia"` / `"eip155:11155111"`.
+     *
+     * @throws {@link ConfigError} if the network is not recognised.
+     *
+     * @example
+     * ```ts
+     * new ConfigBuilder().network("base-sepolia").walletPrivateKey("0x...").build();
+     * new ConfigBuilder().network("eip155:84532").walletPrivateKey("0x...").build();
+     * ```
+     */
+    network(value: string): ConfigBuilder;
     /** Set the wallet private key (hex string). Mutually exclusive with {@link signer}. */
     walletPrivateKey(value: string): ConfigBuilder;
     /** Set a pre-built viem `Account` directly. Mutually exclusive with {@link walletPrivateKey}. */
@@ -65,6 +82,7 @@ export declare class ConfigBuilder {
      * Load configuration from environment variables.
      *
      * Recognised variables:
+     * - `4MICA_NETWORK` — shorthand or CAIP-2 id (e.g. `base-sepolia`); takes precedence over `4MICA_RPC_URL`
      * - `4MICA_RPC_URL`
      * - `4MICA_WALLET_PRIVATE_KEY`
      * - `4MICA_ETHEREUM_HTTP_RPC_URL`

package/dist/config.js

@@ -4,6 +4,7 @@ exports.ConfigBuilder = void 0;
 const accounts_1 = require("viem/accounts");
 const errors_1 = require("./errors");
 const utils_1 = require("./utils");
+const networks_1 = require("./networks");
 /**
  * Fluent builder for {@link Config}.
  *
@@ -17,7 +18,7 @@ const utils_1 = require("./utils");
  * All fields can also be supplied from environment variables via {@link fromEnv}.
  */
 class ConfigBuilder {
-    _rpcUrl = 'https://api.4mica.xyz/';
+    _rpcUrl = 'https://ethereum.sepolia.api.4mica.xyz/';
     _walletPrivateKey;
     _signer;
     _ethereumHttpRpcUrl;
@@ -27,11 +28,35 @@ class ConfigBuilder {
     _authEnabled = true;
     _authUrl;
     _authRefreshMarginSecs;
-    /** Override the 4Mica core RPC URL. Defaults to `https://api.4mica.xyz/`. */
+    /** Set the 4Mica core RPC URL directly. Use {@link network} to select a hosted network by name instead. Defaults to `https://ethereum.sepolia.api.4mica.xyz/`. */
     rpcUrl(value) {
         this._rpcUrl = value;
         return this;
     }
+    /**
+     * Select a hosted 4Mica network by shorthand or CAIP-2 identifier.
+     * Resolves to the corresponding core API URL.
+     * Mutually exclusive with {@link rpcUrl} — last call wins.
+     *
+     * Supported values: `"base-sepolia"` / `"eip155:84532"`,
+     * `"ethereum-sepolia"` / `"eip155:11155111"`.
+     *
+     * @throws {@link ConfigError} if the network is not recognised.
+     *
+     * @example
+     * ```ts
+     * new ConfigBuilder().network("base-sepolia").walletPrivateKey("0x...").build();
+     * new ConfigBuilder().network("eip155:84532").walletPrivateKey("0x...").build();
+     * ```
+     */
+    network(value) {
+        const url = (0, networks_1.resolveNetworkRpcUrl)(value);
+        if (!url) {
+            throw new errors_1.ConfigError(`unknown network "${value}". Use a known shorthand (e.g. "base-sepolia") or CAIP-2 id, or call rpcUrl() directly.`);
+        }
+        this._rpcUrl = url;
+        return this;
+    }
     /** Set the wallet private key (hex string). Mutually exclusive with {@link signer}. */
     walletPrivateKey(value) {
         this._walletPrivateKey = value;
@@ -83,6 +108,7 @@ class ConfigBuilder {
      * Load configuration from environment variables.
      *
      * Recognised variables:
+     * - `4MICA_NETWORK` — shorthand or CAIP-2 id (e.g. `base-sepolia`); takes precedence over `4MICA_RPC_URL`
      * - `4MICA_RPC_URL`
      * - `4MICA_WALLET_PRIVATE_KEY`
      * - `4MICA_ETHEREUM_HTTP_RPC_URL`
@@ -94,6 +120,8 @@ class ConfigBuilder {
      */
     fromEnv() {
         const env = process.env;
+        if (env['4MICA_NETWORK'])
+            this.network(env['4MICA_NETWORK']);
         if (env['4MICA_RPC_URL'])
             this._rpcUrl = env['4MICA_RPC_URL'];
         if (env['4MICA_WALLET_PRIVATE_KEY'])

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './errors';
 export * from './constants';
+export * from './networks';
 export * from './config';
 export * from './utils';
 export * from './models';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./errors"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./networks"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./models"), exports);

package/dist/networks.d.ts

@@ -0,0 +1,40 @@
+/** Metadata for a hosted 4Mica network deployment. */
+export interface NetworkInfo {
+    /** CAIP-2 network identifier (e.g. `eip155:84532`). */
+    caip2: string;
+    /** Hosted 4Mica core API URL for this network. */
+    rpcUrl: string;
+}
+/**
+ * Hosted 4Mica network deployments, keyed by human-readable shorthand.
+ *
+ * Pass the shorthand (or the CAIP-2 string) to {@link ConfigBuilder.network}
+ * to select a network without writing a URL.
+ *
+ * @example
+ * ```ts
+ * import { Client, ConfigBuilder, NETWORKS } from "@4mica/sdk";
+ *
+ * // By shorthand
+ * const cfg = new ConfigBuilder()
+ *   .network("base-sepolia")
+ *   .walletPrivateKey("0x...")
+ *   .build();
+ *
+ * // Inspect available networks
+ * console.log(NETWORKS["base-sepolia"].caip2); // "eip155:84532"
+ * ```
+ */
+export declare const NETWORKS: Record<string, NetworkInfo>;
+/**
+ * Resolve a network shorthand or CAIP-2 identifier to a core API URL.
+ * Returns `undefined` if the identifier is not a known hosted network.
+ *
+ * @example
+ * ```ts
+ * resolveNetworkRpcUrl("base-sepolia");   // "https://base.sepolia.api.4mica.xyz/"
+ * resolveNetworkRpcUrl("eip155:84532");   // "https://base.sepolia.api.4mica.xyz/"
+ * resolveNetworkRpcUrl("eip155:1");       // undefined
+ * ```
+ */
+export declare function resolveNetworkRpcUrl(network: string): string | undefined;

package/dist/networks.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORKS = void 0;
+exports.resolveNetworkRpcUrl = resolveNetworkRpcUrl;
+/**
+ * Hosted 4Mica network deployments, keyed by human-readable shorthand.
+ *
+ * Pass the shorthand (or the CAIP-2 string) to {@link ConfigBuilder.network}
+ * to select a network without writing a URL.
+ *
+ * @example
+ * ```ts
+ * import { Client, ConfigBuilder, NETWORKS } from "@4mica/sdk";
+ *
+ * // By shorthand
+ * const cfg = new ConfigBuilder()
+ *   .network("base-sepolia")
+ *   .walletPrivateKey("0x...")
+ *   .build();
+ *
+ * // Inspect available networks
+ * console.log(NETWORKS["base-sepolia"].caip2); // "eip155:84532"
+ * ```
+ */
+exports.NETWORKS = {
+    'base-sepolia': {
+        caip2: 'eip155:84532',
+        rpcUrl: 'https://base.sepolia.api.4mica.xyz/',
+    },
+    'ethereum-sepolia': {
+        caip2: 'eip155:11155111',
+        rpcUrl: 'https://ethereum.sepolia.api.4mica.xyz/',
+    },
+};
+const NETWORKS_BY_CAIP2 = Object.fromEntries(Object.values(exports.NETWORKS).map((n) => [n.caip2, n]));
+/**
+ * Resolve a network shorthand or CAIP-2 identifier to a core API URL.
+ * Returns `undefined` if the identifier is not a known hosted network.
+ *
+ * @example
+ * ```ts
+ * resolveNetworkRpcUrl("base-sepolia");   // "https://base.sepolia.api.4mica.xyz/"
+ * resolveNetworkRpcUrl("eip155:84532");   // "https://base.sepolia.api.4mica.xyz/"
+ * resolveNetworkRpcUrl("eip155:1");       // undefined
+ * ```
+ */
+function resolveNetworkRpcUrl(network) {
+    return exports.NETWORKS[network]?.rpcUrl ?? NETWORKS_BY_CAIP2[network]?.rpcUrl;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/sdk",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "TypeScript SDK for interacting with the 4Mica payment network",
   "license": "MIT",
   "repository": {
@@ -49,8 +49,8 @@
     "fmt": "prettier --check \"{src,tests}/**/*.{ts,js,json}\""
   },
   "dependencies": {
-    "@4mica/x402": "file:../x402-4mica/packages/typescript/x402",
-    "@noble/curves": "^2.0.1",
+    "@4mica/x402": "^1.2.0",
+    "@noble/curves": "^2.2.0",
     "@quillai-network/wachai-validation-sdk": "^0.1.0",
     "viem": "^2.45.1"
   },
@@ -70,4 +70,4 @@
     "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.17"
   }
-}
+}