@unicitylabs/sphere-sdk 0.1.4 → 0.1.6

package/dist/impl/nodejs/index.d.cts

@@ -236,13 +236,17 @@ declare class FileStorageProvider implements StorageProvider {
     has(key: string): Promise<boolean>;
     keys(prefix?: string): Promise<string[]>;
     clear(prefix?: string): Promise<void>;
+    /**
+     * Get full storage key with address prefix for per-address keys
+     */
+    private getFullKey;
     private save;
 }
 declare function createFileStorageProvider(config: FileStorageProviderConfig | string): FileStorageProvider;
 
 /**
  * File Token Storage Provider for Node.js
- * Stores tokens as individual JSON files
+ * Stores tokens as individual JSON files in per-address subdirectories
  */
 
 interface FileTokenStorageConfig {
@@ -253,11 +257,16 @@ declare class FileTokenStorageProvider implements TokenStorageProvider<TxfStorag
     readonly id = "file-token-storage";
     readonly name = "File Token Storage";
     readonly type: "local";
-    private tokensDir;
+    private baseTokensDir;
     private status;
     private identity;
     constructor(config: FileTokenStorageConfig | string);
     setIdentity(identity: FullIdentity): void;
+    /**
+     * Get tokens directory for current address
+     * Format: {baseTokensDir}/{addressId}/
+     */
+    private get tokensDir();
     initialize(): Promise<boolean>;
     shutdown(): Promise<void>;
     connect(): Promise<void>;

package/dist/impl/nodejs/index.d.ts

@@ -236,13 +236,17 @@ declare class FileStorageProvider implements StorageProvider {
     has(key: string): Promise<boolean>;
     keys(prefix?: string): Promise<string[]>;
     clear(prefix?: string): Promise<void>;
+    /**
+     * Get full storage key with address prefix for per-address keys
+     */
+    private getFullKey;
     private save;
 }
 declare function createFileStorageProvider(config: FileStorageProviderConfig | string): FileStorageProvider;
 
 /**
  * File Token Storage Provider for Node.js
- * Stores tokens as individual JSON files
+ * Stores tokens as individual JSON files in per-address subdirectories
  */
 
 interface FileTokenStorageConfig {
@@ -253,11 +257,16 @@ declare class FileTokenStorageProvider implements TokenStorageProvider<TxfStorag
     readonly id = "file-token-storage";
     readonly name = "File Token Storage";
     readonly type: "local";
-    private tokensDir;
+    private baseTokensDir;
     private status;
     private identity;
     constructor(config: FileTokenStorageConfig | string);
     setIdentity(identity: FullIdentity): void;
+    /**
+     * Get tokens directory for current address
+     * Format: {baseTokensDir}/{addressId}/
+     */
+    private get tokensDir();
     initialize(): Promise<boolean>;
     shutdown(): Promise<void>;
     connect(): Promise<void>;

package/dist/impl/nodejs/index.js

@@ -1,6 +1,131 @@
 // impl/nodejs/storage/FileStorageProvider.ts
 import * as fs from "fs";
 import * as path from "path";
+
+// constants.ts
+var STORAGE_KEYS_GLOBAL = {
+  /** Encrypted BIP39 mnemonic */
+  MNEMONIC: "mnemonic",
+  /** Encrypted master private key */
+  MASTER_KEY: "master_key",
+  /** BIP32 chain code */
+  CHAIN_CODE: "chain_code",
+  /** HD derivation path (full path like m/44'/0'/0'/0/0) */
+  DERIVATION_PATH: "derivation_path",
+  /** Base derivation path (like m/44'/0'/0' without chain/index) */
+  BASE_PATH: "base_path",
+  /** Derivation mode: bip32, wif_hmac, legacy_hmac */
+  DERIVATION_MODE: "derivation_mode",
+  /** Wallet source: mnemonic, file, unknown */
+  WALLET_SOURCE: "wallet_source",
+  /** Wallet existence flag */
+  WALLET_EXISTS: "wallet_exists",
+  /** Current active address index */
+  CURRENT_ADDRESS_INDEX: "current_address_index",
+  /** Index of address nametags (JSON: { "0": "alice", "1": "bob" }) - for discovery */
+  ADDRESS_NAMETAGS: "address_nametags"
+};
+var STORAGE_KEYS_ADDRESS = {
+  /** Pending transfers for this address */
+  PENDING_TRANSFERS: "pending_transfers",
+  /** Transfer outbox for this address */
+  OUTBOX: "outbox",
+  /** Conversations for this address */
+  CONVERSATIONS: "conversations",
+  /** Messages for this address */
+  MESSAGES: "messages",
+  /** Transaction history for this address */
+  TRANSACTION_HISTORY: "transaction_history"
+};
+var STORAGE_KEYS = {
+  ...STORAGE_KEYS_GLOBAL,
+  ...STORAGE_KEYS_ADDRESS
+};
+function getAddressId(directAddress) {
+  let hash = directAddress;
+  if (hash.startsWith("DIRECT://")) {
+    hash = hash.slice(9);
+  } else if (hash.startsWith("DIRECT:")) {
+    hash = hash.slice(7);
+  }
+  const first = hash.slice(0, 6).toLowerCase();
+  const last = hash.slice(-6).toLowerCase();
+  return `DIRECT_${first}_${last}`;
+}
+var DEFAULT_NOSTR_RELAYS = [
+  "wss://relay.unicity.network",
+  "wss://relay.damus.io",
+  "wss://nos.lol",
+  "wss://relay.nostr.band"
+];
+var NOSTR_EVENT_KINDS = {
+  /** NIP-04 encrypted direct message */
+  DIRECT_MESSAGE: 4,
+  /** Token transfer (Unicity custom - 31113) */
+  TOKEN_TRANSFER: 31113,
+  /** Payment request (Unicity custom - 31115) */
+  PAYMENT_REQUEST: 31115,
+  /** Payment request response (Unicity custom - 31116) */
+  PAYMENT_REQUEST_RESPONSE: 31116,
+  /** Nametag binding (NIP-78 app-specific data) */
+  NAMETAG_BINDING: 30078,
+  /** Public broadcast */
+  BROADCAST: 1
+};
+var DEFAULT_AGGREGATOR_URL = "https://aggregator.unicity.network/rpc";
+var DEV_AGGREGATOR_URL = "https://dev-aggregator.dyndns.org/rpc";
+var TEST_AGGREGATOR_URL = "https://goggregator-test.unicity.network";
+var DEFAULT_AGGREGATOR_TIMEOUT = 3e4;
+var DEFAULT_AGGREGATOR_API_KEY = "sk_06365a9c44654841a366068bcfc68986";
+var DEFAULT_IPFS_GATEWAYS = [
+  "https://ipfs.unicity.network",
+  "https://dweb.link",
+  "https://ipfs.io"
+];
+var DEFAULT_BASE_PATH = "m/44'/0'/0'";
+var DEFAULT_DERIVATION_PATH = `${DEFAULT_BASE_PATH}/0/0`;
+var DEFAULT_ELECTRUM_URL = "wss://fulcrum.alpha.unicity.network:50004";
+var TEST_ELECTRUM_URL = "wss://fulcrum.alpha.testnet.unicity.network:50004";
+var TEST_NOSTR_RELAYS = [
+  "wss://nostr-relay.testnet.unicity.network"
+];
+var NETWORKS = {
+  mainnet: {
+    name: "Mainnet",
+    aggregatorUrl: DEFAULT_AGGREGATOR_URL,
+    nostrRelays: DEFAULT_NOSTR_RELAYS,
+    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
+    electrumUrl: DEFAULT_ELECTRUM_URL
+  },
+  testnet: {
+    name: "Testnet",
+    aggregatorUrl: TEST_AGGREGATOR_URL,
+    nostrRelays: TEST_NOSTR_RELAYS,
+    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
+    electrumUrl: TEST_ELECTRUM_URL
+  },
+  dev: {
+    name: "Development",
+    aggregatorUrl: DEV_AGGREGATOR_URL,
+    nostrRelays: TEST_NOSTR_RELAYS,
+    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
+    electrumUrl: TEST_ELECTRUM_URL
+  }
+};
+var TIMEOUTS = {
+  /** WebSocket connection timeout */
+  WEBSOCKET_CONNECT: 1e4,
+  /** Nostr relay reconnect delay */
+  NOSTR_RECONNECT_DELAY: 3e3,
+  /** Max reconnect attempts */
+  MAX_RECONNECT_ATTEMPTS: 5,
+  /** Proof polling interval */
+  PROOF_POLL_INTERVAL: 1e3,
+  /** Sync interval */
+  SYNC_INTERVAL: 6e4
+};
+
+// impl/nodejs/storage/FileStorageProvider.ts
 var FileStorageProvider = class {
   id = "file-storage";
   name = "File Storage";
@@ -53,18 +178,22 @@ var FileStorageProvider = class {
     return this.status;
   }
   async get(key) {
-    return this.data[key] ?? null;
+    const fullKey = this.getFullKey(key);
+    return this.data[fullKey] ?? null;
   }
   async set(key, value) {
-    this.data[key] = value;
+    const fullKey = this.getFullKey(key);
+    this.data[fullKey] = value;
     await this.save();
   }
   async remove(key) {
-    delete this.data[key];
+    const fullKey = this.getFullKey(key);
+    delete this.data[fullKey];
     await this.save();
   }
   async has(key) {
-    return key in this.data;
+    const fullKey = this.getFullKey(key);
+    return fullKey in this.data;
   }
   async keys(prefix) {
     const allKeys = Object.keys(this.data);
@@ -84,6 +213,19 @@ var FileStorageProvider = class {
     }
     await this.save();
   }
+  /**
+   * Get full storage key with address prefix for per-address keys
+   */
+  getFullKey(key) {
+    const isPerAddressKey = Object.values(STORAGE_KEYS_ADDRESS).includes(
+      key
+    );
+    if (isPerAddressKey && this._identity?.directAddress) {
+      const addressId = getAddressId(this._identity.directAddress);
+      return `${addressId}_${key}`;
+    }
+    return key;
+  }
   async save() {
     if (!fs.existsSync(this.dataDir)) {
       fs.mkdirSync(this.dataDir, { recursive: true });
@@ -102,15 +244,26 @@ var FileTokenStorageProvider = class {
   id = "file-token-storage";
   name = "File Token Storage";
   type = "local";
-  tokensDir;
+  baseTokensDir;
   status = "disconnected";
   identity = null;
   constructor(config) {
-    this.tokensDir = typeof config === "string" ? config : config.tokensDir;
+    this.baseTokensDir = typeof config === "string" ? config : config.tokensDir;
   }
   setIdentity(identity) {
     this.identity = identity;
   }
+  /**
+   * Get tokens directory for current address
+   * Format: {baseTokensDir}/{addressId}/
+   */
+  get tokensDir() {
+    if (this.identity?.directAddress) {
+      const addressId = getAddressId(this.identity.directAddress);
+      return path2.join(this.baseTokensDir, addressId);
+    }
+    return this.baseTokensDir;
+  }
   async initialize() {
     if (!fs2.existsSync(this.tokensDir)) {
       fs2.mkdirSync(this.tokensDir, { recursive: true });
@@ -822,122 +975,6 @@ function defaultUUIDGenerator() {
   });
 }
 
-// constants.ts
-var STORAGE_PREFIX = "sphere_";
-var STORAGE_KEYS = {
-  /** Encrypted BIP39 mnemonic */
-  MNEMONIC: `${STORAGE_PREFIX}mnemonic`,
-  /** Encrypted master private key */
-  MASTER_KEY: `${STORAGE_PREFIX}master_key`,
-  /** BIP32 chain code */
-  CHAIN_CODE: `${STORAGE_PREFIX}chain_code`,
-  /** HD derivation path (full path like m/44'/0'/0'/0/0) */
-  DERIVATION_PATH: `${STORAGE_PREFIX}derivation_path`,
-  /** Base derivation path (like m/44'/0'/0' without chain/index) */
-  BASE_PATH: `${STORAGE_PREFIX}base_path`,
-  /** Derivation mode: bip32, wif_hmac, legacy_hmac */
-  DERIVATION_MODE: `${STORAGE_PREFIX}derivation_mode`,
-  /** Wallet source: mnemonic, file, unknown */
-  WALLET_SOURCE: `${STORAGE_PREFIX}wallet_source`,
-  /** Wallet existence flag */
-  WALLET_EXISTS: `${STORAGE_PREFIX}wallet_exists`,
-  /** Registered nametag (legacy - single address) */
-  NAMETAG: `${STORAGE_PREFIX}nametag`,
-  /** Current active address index */
-  CURRENT_ADDRESS_INDEX: `${STORAGE_PREFIX}current_address_index`,
-  /** Address nametags map (JSON: { "0": "alice", "1": "bob" }) */
-  ADDRESS_NAMETAGS: `${STORAGE_PREFIX}address_nametags`,
-  /** Token data */
-  TOKENS: `${STORAGE_PREFIX}tokens`,
-  /** Pending transfers */
-  PENDING_TRANSFERS: `${STORAGE_PREFIX}pending_transfers`,
-  /** Transfer outbox */
-  OUTBOX: `${STORAGE_PREFIX}outbox`,
-  /** Conversations */
-  CONVERSATIONS: `${STORAGE_PREFIX}conversations`,
-  /** Messages */
-  MESSAGES: `${STORAGE_PREFIX}messages`,
-  /** Transaction history */
-  TRANSACTION_HISTORY: `${STORAGE_PREFIX}transaction_history`,
-  /** Archived tokens (spent token history) */
-  ARCHIVED_TOKENS: `${STORAGE_PREFIX}archived_tokens`,
-  /** Tombstones (records of deleted/spent tokens) */
-  TOMBSTONES: `${STORAGE_PREFIX}tombstones`,
-  /** Forked tokens (alternative histories) */
-  FORKED_TOKENS: `${STORAGE_PREFIX}forked_tokens`
-};
-var DEFAULT_NOSTR_RELAYS = [
-  "wss://relay.unicity.network",
-  "wss://relay.damus.io",
-  "wss://nos.lol",
-  "wss://relay.nostr.band"
-];
-var NOSTR_EVENT_KINDS = {
-  /** NIP-04 encrypted direct message */
-  DIRECT_MESSAGE: 4,
-  /** Token transfer (Unicity custom - 31113) */
-  TOKEN_TRANSFER: 31113,
-  /** Payment request (Unicity custom - 31115) */
-  PAYMENT_REQUEST: 31115,
-  /** Payment request response (Unicity custom - 31116) */
-  PAYMENT_REQUEST_RESPONSE: 31116,
-  /** Nametag binding (NIP-78 app-specific data) */
-  NAMETAG_BINDING: 30078,
-  /** Public broadcast */
-  BROADCAST: 1
-};
-var DEFAULT_AGGREGATOR_URL = "https://aggregator.unicity.network/rpc";
-var DEV_AGGREGATOR_URL = "https://dev-aggregator.dyndns.org/rpc";
-var TEST_AGGREGATOR_URL = "https://goggregator-test.unicity.network";
-var DEFAULT_AGGREGATOR_TIMEOUT = 3e4;
-var DEFAULT_IPFS_GATEWAYS = [
-  "https://ipfs.unicity.network",
-  "https://dweb.link",
-  "https://ipfs.io"
-];
-var DEFAULT_BASE_PATH = "m/44'/0'/0'";
-var DEFAULT_DERIVATION_PATH = `${DEFAULT_BASE_PATH}/0/0`;
-var DEFAULT_ELECTRUM_URL = "wss://fulcrum.alpha.unicity.network:50004";
-var TEST_ELECTRUM_URL = "wss://fulcrum.alpha.testnet.unicity.network:50004";
-var TEST_NOSTR_RELAYS = [
-  "wss://nostr-relay.testnet.unicity.network"
-];
-var NETWORKS = {
-  mainnet: {
-    name: "Mainnet",
-    aggregatorUrl: DEFAULT_AGGREGATOR_URL,
-    nostrRelays: DEFAULT_NOSTR_RELAYS,
-    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: DEFAULT_ELECTRUM_URL
-  },
-  testnet: {
-    name: "Testnet",
-    aggregatorUrl: TEST_AGGREGATOR_URL,
-    nostrRelays: TEST_NOSTR_RELAYS,
-    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: TEST_ELECTRUM_URL
-  },
-  dev: {
-    name: "Development",
-    aggregatorUrl: DEV_AGGREGATOR_URL,
-    nostrRelays: TEST_NOSTR_RELAYS,
-    ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: TEST_ELECTRUM_URL
-  }
-};
-var TIMEOUTS = {
-  /** WebSocket connection timeout */
-  WEBSOCKET_CONNECT: 1e4,
-  /** Nostr relay reconnect delay */
-  NOSTR_RECONNECT_DELAY: 3e3,
-  /** Max reconnect attempts */
-  MAX_RECONNECT_ATTEMPTS: 5,
-  /** Proof polling interval */
-  PROOF_POLL_INTERVAL: 1e3,
-  /** Sync interval */
-  SYNC_INTERVAL: 6e4
-};
-
 // transport/NostrTransportProvider.ts
 var EVENT_KINDS = NOSTR_EVENT_KINDS;
 function deriveNametagEncryptionKey(privateKeyHex) {
@@ -2510,7 +2547,7 @@ function resolveOracleConfig(network, config) {
   const networkConfig = getNetworkConfig(network);
   return {
     url: config?.url ?? networkConfig.aggregatorUrl,
-    apiKey: config?.apiKey,
+    apiKey: config?.apiKey ?? DEFAULT_AGGREGATOR_API_KEY,
     timeout: config?.timeout,
     skipVerification: config?.skipVerification,
     debug: config?.debug,