@dotdm/env 0.1.0

package/dist/connection.d.ts

@@ -0,0 +1,36 @@
+import type { PolkadotClient, TypedApi } from "polkadot-api";
+import type { AssetHub, Bulletin } from "@polkadot-api/descriptors";
+export interface AssetHubConnection {
+    client: PolkadotClient;
+    api: TypedApi<AssetHub>;
+}
+/**
+ * Detect connection type from URL.
+ * - ws:// or wss:// -> WebSocket
+ * - file path -> smoldot with chainspec
+ */
+export declare function detectConnectionType(url: string): "websocket" | "smoldot";
+/**
+ * Connect to a chain via WebSocket.
+ */
+export declare function connectAssetHubWebSocket(url: string): AssetHubConnection;
+export interface BulletinConnection {
+    client: PolkadotClient;
+    api: TypedApi<Bulletin>;
+}
+/**
+ * Connect to the Bulletin chain via WebSocket.
+ */
+export declare function connectBulletinWebSocket(url: string): BulletinConnection;
+/**
+ * Connect to a parachain via smoldot light client.
+ *
+ * @param parachainChainspec - Path to the parachain chainspec JSON file
+ * @param relayChainspec - Path to the relay chain chainspec JSON file
+ */
+export declare function connectSmoldot(parachainChainspec: string, relayChainspec: string): Promise<AssetHubConnection>;
+export interface IpfsGateway {
+    fetch: (cid: string) => Promise<Response>;
+}
+export declare function connectIpfsGateway(url: string): IpfsGateway;
+//# 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":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM7D,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAKzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAGxE;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAGxE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAChC,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAED,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAQ3D"}

package/dist/connection.js

@@ -0,0 +1,60 @@
+import { createClient } from "polkadot-api";
+import { getSmProvider } from "polkadot-api/sm-provider";
+import { start } from "polkadot-api/smoldot";
+import { getWsProvider } from "polkadot-api/ws-provider";
+import { withPolkadotSdkCompat } from "polkadot-api/polkadot-sdk-compat";
+import { assetHub, bulletin } from "@polkadot-api/descriptors";
+/**
+ * Detect connection type from URL.
+ * - ws:// or wss:// -> WebSocket
+ * - file path -> smoldot with chainspec
+ */
+export function detectConnectionType(url) {
+    if (url.startsWith("ws://") || url.startsWith("wss://")) {
+        return "websocket";
+    }
+    return "smoldot";
+}
+/**
+ * Connect to a chain via WebSocket.
+ */
+export function connectAssetHubWebSocket(url) {
+    const client = createClient(withPolkadotSdkCompat(getWsProvider(url)));
+    return { client, api: client.getTypedApi(assetHub) };
+}
+/**
+ * Connect to the Bulletin chain via WebSocket.
+ */
+export function connectBulletinWebSocket(url) {
+    const client = createClient(withPolkadotSdkCompat(getWsProvider(url)));
+    return { client, api: client.getTypedApi(bulletin) };
+}
+/**
+ * Connect to a parachain via smoldot light client.
+ *
+ * @param parachainChainspec - Path to the parachain chainspec JSON file
+ * @param relayChainspec - Path to the relay chain chainspec JSON file
+ */
+export async function connectSmoldot(parachainChainspec, relayChainspec) {
+    const smoldot = start();
+    const { readFileSync } = await import("fs");
+    const relaySpec = readFileSync(relayChainspec, "utf-8");
+    const parachainSpec = readFileSync(parachainChainspec, "utf-8");
+    const relayChain = await smoldot.addChain({ chainSpec: relaySpec });
+    const parachain = await smoldot.addChain({
+        chainSpec: parachainSpec,
+        potentialRelayChains: [relayChain],
+    });
+    const client = createClient(getSmProvider(parachain));
+    return { client, api: client.getTypedApi(assetHub) };
+}
+export function connectIpfsGateway(url) {
+    return {
+        fetch: (cid) => globalThis.fetch(`${url}/${cid}`, { signal: AbortSignal.timeout(10_000) }).then((r) => {
+            if (!r.ok)
+                throw new Error(`IPFS fetch failed: ${r.statusText}`);
+            return r;
+        }),
+    };
+}
+//# 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,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAQ/D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzD,CAAC;AAOD;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,kBAA0B,EAC1B,cAAsB;IAEtB,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IAExB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAEhE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;QACrC,SAAS,EAAE,aAAa;QACxB,oBAAoB,EAAE,CAAC,UAAU,CAAC;KACrC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzD,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC1C,OAAO;QACH,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CACnB,UAAU,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAClF,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;QACb,CAAC,CAAC;KACT,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { ChainPreset, KnownChainName } from "./known_chains";
+export { KNOWN_CHAINS, getChainPreset } from "./known_chains";
+export { DEFAULT_NODE_URL } from "@dotdm/utils";
+export type { AssetHubConnection, BulletinConnection, IpfsGateway } from "./connection";
+export { detectConnectionType, connectAssetHubWebSocket, connectBulletinWebSocket, connectSmoldot, connectIpfsGateway, } from "./connection";
+export { prepareSigner, prepareSignerFromSuri } from "./signer";
+//# 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":"AAAA,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { KNOWN_CHAINS, getChainPreset } from "./known_chains";
+export { DEFAULT_NODE_URL } from "@dotdm/utils";
+export { detectConnectionType, connectAssetHubWebSocket, connectBulletinWebSocket, connectSmoldot, connectIpfsGateway, } from "./connection";
+export { prepareSigner, prepareSignerFromSuri } from "./signer";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC"}

package/dist/known_chains.d.ts

@@ -0,0 +1,10 @@
+export interface ChainPreset {
+    assethubUrl: string;
+    bulletinUrl: string;
+    ipfsGatewayUrl: string;
+    registryAddress?: string;
+}
+export declare const KNOWN_CHAINS: Record<string, ChainPreset>;
+export type KnownChainName = keyof typeof KNOWN_CHAINS;
+export declare function getChainPreset(name: string): ChainPreset;
+//# sourceMappingURL=known_chains.d.ts.map

package/dist/known_chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known_chains.d.ts","sourceRoot":"","sources":["../src/known_chains.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAwBpD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAOxD"}

package/dist/known_chains.js

@@ -0,0 +1,34 @@
+export const KNOWN_CHAINS = {
+    polkadot: {
+        assethubUrl: "wss://polkadot-asset-hub-rpc.polkadot.io",
+        bulletinUrl: "wss://polkadot-bulletin-rpc.polkadot.io",
+        ipfsGatewayUrl: "https://polkadot-bulletin-rpc.polkadot.io/ipfs",
+        registryAddress: undefined, // TODO: set once deployed
+    },
+    paseo: {
+        assethubUrl: "wss://asset-hub-paseo-rpc.n.dwellir.com",
+        bulletinUrl: "wss://bulletin.dotspark.app",
+        ipfsGatewayUrl: "https://ipfs.dotspark.app/ipfs",
+        registryAddress: "0xd984e8407838138eff926814b802a66f3938017f",
+    },
+    "preview-net": {
+        assethubUrl: "wss://previewnet.substrate.dev/asset-hub",
+        bulletinUrl: "wss://bulletin.dotspark.app",
+        ipfsGatewayUrl: "https://ipfs.dotspark.app/ipfs",
+        registryAddress: "0xf78bc1cd6e8e13d178dd0b1aaeb71e9d094327a3",
+    },
+    local: {
+        assethubUrl: "ws://127.0.0.1:10020",
+        bulletinUrl: "ws://127.0.0.1:10030",
+        ipfsGatewayUrl: "http://127.0.0.1:8283/ipfs",
+    },
+};
+export function getChainPreset(name) {
+    const preset = KNOWN_CHAINS[name];
+    if (!preset) {
+        const valid = Object.keys(KNOWN_CHAINS).join(", ");
+        throw new Error(`Unknown chain "${name}". Valid names: ${valid}`);
+    }
+    return preset;
+}
+//# sourceMappingURL=known_chains.js.map

package/dist/known_chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known_chains.js","sourceRoot":"","sources":["../src/known_chains.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,YAAY,GAAgC;IACrD,QAAQ,EAAE;QACN,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,yCAAyC;QACtD,cAAc,EAAE,gDAAgD;QAChE,eAAe,EAAE,SAAS,EAAE,0BAA0B;KACzD;IACD,KAAK,EAAE;QACH,WAAW,EAAE,yCAAyC;QACtD,WAAW,EAAE,6BAA6B;QAC1C,cAAc,EAAE,gCAAgC;QAChD,eAAe,EAAE,4CAA4C;KAChE;IACD,aAAa,EAAE;QACX,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE,6BAA6B;QAC1C,cAAc,EAAE,gCAAgC;QAChD,eAAe,EAAE,4CAA4C;KAChE;IACD,KAAK,EAAE;QACH,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,sBAAsB;QACnC,cAAc,EAAE,4BAA4B;KAC/C;CACJ,CAAC;AAIF,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,mBAAmB,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/signer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prepares a signer from a dev account name (e.g., "Alice", "Bob").
+ * Uses sr25519 key derivation compatible with Substrate dev accounts.
+ */
+export declare function prepareSigner(name: string): import("polkadot-api").PolkadotSigner;
+/**
+ * Prepares a signer from a secret URI (SURI).
+ * Format: "//Alice" for dev accounts or a full mnemonic + derivation path.
+ */
+export declare function prepareSignerFromSuri(suri: string): import("polkadot-api").PolkadotSigner;
+//# sourceMappingURL=signer.d.ts.map

package/dist/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,yCAOzC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,yCAWjD"}

package/dist/signer.js

@@ -0,0 +1,28 @@
+import { getPolkadotSigner } from "polkadot-api/signer";
+import { sr25519CreateDerive } from "@polkadot-labs/hdkd";
+import { DEV_PHRASE, entropyToMiniSecret, mnemonicToEntropy } from "@polkadot-labs/hdkd-helpers";
+/**
+ * Prepares a signer from a dev account name (e.g., "Alice", "Bob").
+ * Uses sr25519 key derivation compatible with Substrate dev accounts.
+ */
+export function prepareSigner(name) {
+    const entropy = mnemonicToEntropy(DEV_PHRASE);
+    const miniSecret = entropyToMiniSecret(entropy);
+    const derive = sr25519CreateDerive(miniSecret);
+    const hdkdKeyPair = derive(`//${name}`);
+    return getPolkadotSigner(hdkdKeyPair.publicKey, "Sr25519", hdkdKeyPair.sign);
+}
+/**
+ * Prepares a signer from a secret URI (SURI).
+ * Format: "//Alice" for dev accounts or a full mnemonic + derivation path.
+ */
+export function prepareSignerFromSuri(suri) {
+    // Simple case: dev account shorthand like "//Alice"
+    if (suri.startsWith("//")) {
+        return prepareSigner(suri.slice(2));
+    }
+    // For now, just support dev accounts
+    // TODO: Support full mnemonics with derivation paths
+    throw new Error("Custom SURI not yet supported. Use dev account names like 'Alice' or '//Alice'");
+}
+//# sourceMappingURL=signer.js.map

package/dist/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEjG;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAExC,OAAO,iBAAiB,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAC9C,oDAAoD;IACpD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,qCAAqC;IACrC,qDAAqD;IACrD,MAAM,IAAI,KAAK,CACX,gFAAgF,CACnF,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@dotdm/env",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@polkadot-labs/hdkd": "^0.0.26",
+    "@polkadot-labs/hdkd-helpers": "^0.0.27",
+    "polkadot-api": "^1.23.3",
+    "smoldot": "^2.0.40",
+    "@dotdm/utils": "0.1.0"
+  },
+  "peerDependencies": {
+    "@polkadot-api/descriptors": "*"
+  },
+  "peerDependenciesMeta": {
+    "@polkadot-api/descriptors": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "@polkadot-api/descriptors": "0.1.0-autogenerated.11203421873544033963"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  }
+}