@empereur-rouge/pms-sdk 0.3.4 → 0.3.6

package/README.md

@@ -172,13 +172,17 @@ console.log(imported.address); // même adresse que ci-dessus
 #### Méthodes de Lecture
 
 ```typescript
-// Lister les ledgers actifs (avec block_count par ledger)
+// Lister les ledgers actifs (avec block_count et symbol par ledger)
 const ledgers: LedgerInfo[] = await client.listLedgers();
 // Réponse:
 // [
-//   { id: "main", network_id: "mainnet", prefix: "", protocol_version: 1, block_count: 12345 },
-//   { id: "gaming", network_id: "gaming-net", prefix: "gam_", protocol_version: 1, block_count: 678 }
+//   { id: "main", network_id: "mainnet", prefix: "", protocol_version: 1, block_count: 12345, symbol: "PMS" },
+//   { id: "gaming", network_id: "gaming-net", prefix: "gam_", protocol_version: 1, block_count: 678, symbol: "GAME" }
 // ]
+
+// Filtrer par préfixe de nom (starts_with, case-insensitive sur id, network_id ou symbol)
+const gaming = await client.listLedgers({ search: "gam" });
+// → [{ id: "gaming", ... }]
 ```
 
 ```typescript
@@ -266,7 +270,57 @@ const historyWithDecrypt = await client.getHistory(address, {
 // Les items "EncryptedReward" déchiffrés apparaîtront comme des "Reward" standards
 ```
 
-#### Méthodes d'Écriture (Transactions)
+#### Activity API
+
+L'Activity API classifie chaque transaction avec un type semantique (`fee_received`, `transfer_in`, `nft_mint`, `freeze`, etc.), une direction et un montant net. Elle remplace `/wallet/history` (deprecie).
+
+```typescript
+// Toute l'activite d'un wallet
+const activity = await client.getActivity("8eabc...");
+// Reponse: { address, items: ActivityItem[], count, has_more, next_after_ts?, next_after_id? }
+
+// Filtrer par type
+const fees = await client.getActivity("8eabc...", {
+  type: ["fee_received", "reward"],
+  limit: 20,
+});
+
+// Pagination
+const page2 = await client.getActivity("8eabc...", {
+  after_ts: activity.next_after_ts,
+  after_id: activity.next_after_id,
+});
+
+// Filtrer par asset
+const edeniteActivity = await client.getActivity("8eabc...", {
+  asset_id: "edenite",
+});
+
+// Avec dechiffrement des payloads chiffres (EncryptedReward, Encrypted)
+// IMPORTANT: ne passer la cle privee que sur TLS
+const decrypted = await client.getActivity("8eabc...", {
+  x25519_sk_hex: "votre_cle_privee_x25519_hex",
+});
+```
+
+**Streaming temps reel (SSE)** :
+
+```typescript
+const stop = client.streamActivity("8eabc...", {
+  type: ["transfer_in", "fee_received"],
+  x25519_sk_hex: "votre_cle_privee_x25519_hex", // Optionnel: dechiffrement en temps reel
+  onActivity: (item) => {
+    console.log(`${item.activity_type}: ${item.amount} (${item.direction})`);
+  },
+  onError: (err) => console.error("SSE error:", err),
+  onClose: () => console.log("Stream closed"),
+});
+
+// Plus tard: fermer la connexion
+stop();
+```
+
+#### Methodes d'Ecriture (Transactions)
 
 ```typescript
 // Envoyer des tokens
@@ -470,6 +524,14 @@ import type {
   WalletHistoryResp,
   HistoryItem,
 
+  // Activity
+  ActivityItem,
+  ActivityResp,
+  ActivityOptions,
+  StreamActivityOptions,
+  ActivityType,
+  ActivityDirection,
+
   // Ledger
   LedgerInfo,
 } from "@empereur-rouge/pms-sdk";

package/dist/index.cjs

@@ -377,17 +377,26 @@ var PmsClient = class {
   /**
    * Liste tous les ledgers actifs avec leur nombre de blocs.
    *
+   * @param options - Filtrage optionnel
+   * @returns Ledgers correspondants
+   *
    * @example
    * ```typescript
+   * // Tous les ledgers
    * const ledgers = await client.listLedgers();
-   * for (const l of ledgers) {
-   *   console.log(`${l.id}: ${l.block_count} blocks`);
-   * }
+   *
+   * // Filtrer par préfixe de nom (starts_with, case-insensitive)
+   * const gaming = await client.listLedgers({ search: "gam" });
    * ```
    */
-  async listLedgers() {
-    const res = await this.fetch("/v1/ledgers");
-    return res.ledgers ?? [];
+  async listLedgers(options) {
+    const params = new URLSearchParams();
+    if (options?.search) {
+      params.set("search", options.search);
+    }
+    const qs = params.toString();
+    const path = `/v1/ledgers${qs ? `?${qs}` : ""}`;
+    return (await this.fetch(path)).ledgers ?? [];
   }
   /**
    * Récupère un bloc par son ID.
@@ -668,6 +677,11 @@ var PmsClient = class {
    *   after_ts: activity.next_after_ts,
    *   after_id: activity.next_after_id,
    * });
+   *
+   * // Avec déchiffrement des payloads chiffrés (TLS requis)
+   * const decrypted = await client.getActivity("8eabc...", {
+   *   x25519_sk_hex: wallet.x25519PrivateKeyHex,
+   * });
    * ```
    */
   async getActivity(address, options) {
@@ -687,6 +701,9 @@ var PmsClient = class {
     if (options?.asset_id !== void 0) {
       params.set("asset_id", options.asset_id);
     }
+    if (options?.x25519_sk_hex !== void 0) {
+      params.set("x25519_sk_hex", options.x25519_sk_hex);
+    }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity${qs ? `?${qs}` : ""}`;
     return this.fetch(path);
@@ -719,6 +736,9 @@ var PmsClient = class {
     if (options.type && options.type.length > 0) {
       params.set("type", options.type.join(","));
     }
+    if (options.x25519_sk_hex !== void 0) {
+      params.set("x25519_sk_hex", options.x25519_sk_hex);
+    }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity/stream${qs ? `?${qs}` : ""}`;
     const url = `${this.config.nodeUrl}${path}`;

package/dist/index.d.cts

@@ -472,6 +472,8 @@ interface WalletResponse {
     public_key_hex: string;
     /** Clé publique X25519 (hex) */
     x25519_pub_hex: string;
+    /** Clé secrète X25519 (hex, dérivée via HKDF depuis la clé ECDSA) */
+    x25519_sk_hex: string;
     /** Mots mnémoniques (24 mots, absent si restauré depuis clé privée) */
     mnemonic_words?: string[];
 }
@@ -496,6 +498,13 @@ interface LedgerInfo {
     protocol_version: number;
     /** Nombre de blocs dans le DAG */
     block_count: number;
+    /** Symbole du token natif (ex: "PMS") */
+    symbol: string;
+}
+/** Options pour listLedgers() */
+interface ListLedgersOptions {
+    /** Filtre prefix (starts_with, case-insensitive) sur id, network_id ou symbol */
+    search?: string;
 }
 /** Configuration du client PMS */
 interface PmsClientConfig {
@@ -550,11 +559,12 @@ interface WalletHistoryResp {
  * - Minting: "mint"
  * - NFT: "nft_mint", "nft_transfer_in", "nft_transfer_out", "nft_burn", "nft_use"
  * - Bridge: "bridge_lock_in", "bridge_lock_out", "bridge_mint"
- * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reversed", "reverse_received"
+ * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reverse_received"
  * - Token: "token_create"
  * - Reward: "reward"
+ * - Encrypted: "encrypted" (payload chiffré sans clé de déchiffrement)
  */
-type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_lock_out" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reversed" | "reverse_received" | "token_create";
+type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reverse_received" | "token_create" | "encrypted";
 /** Direction de l'activité */
 type ActivityDirection = "in" | "out" | "info";
 /** Élément d'activité classifié pour un wallet */
@@ -597,7 +607,7 @@ interface ActivityResp {
 interface ActivityOptions {
     /** Filtrer par type(s) d'activité (ex: ["fee_received", "transfer_in"]) */
     type?: ActivityType[];
-    /** Nombre max d'éléments (défaut: 50, max: 500) */
+    /** Nombre max d'éléments (défaut: 50, max: 2000) */
     limit?: number;
     /** Cursor de pagination: timestamp */
     after_ts?: number;
@@ -605,11 +615,15 @@ interface ActivityOptions {
     after_id?: string;
     /** Filtrer par asset ID */
     asset_id?: string;
+    /** Clé privée X25519 (hex) pour déchiffrer les payloads chiffrés (EncryptedReward, Encrypted). Requiert TLS. */
+    x25519_sk_hex?: string;
 }
 /** Options pour streamActivity() */
 interface StreamActivityOptions {
     /** Filtrer par type(s) d'activité */
     type?: ActivityType[];
+    /** Clé privée X25519 (hex) pour déchiffrer les payloads chiffrés en temps réel. Requiert TLS. */
+    x25519_sk_hex?: string;
     /** Callback appelé pour chaque activité en temps réel */
     onActivity: (item: ActivityItem) => void;
     /** Callback appelé en cas d'erreur */
@@ -689,15 +703,19 @@ declare class PmsClient {
     /**
      * Liste tous les ledgers actifs avec leur nombre de blocs.
      *
+     * @param options - Filtrage optionnel
+     * @returns Ledgers correspondants
+     *
      * @example
      * ```typescript
+     * // Tous les ledgers
      * const ledgers = await client.listLedgers();
-     * for (const l of ledgers) {
-     *   console.log(`${l.id}: ${l.block_count} blocks`);
-     * }
+     *
+     * // Filtrer par préfixe de nom (starts_with, case-insensitive)
+     * const gaming = await client.listLedgers({ search: "gam" });
      * ```
      */
-    listLedgers(): Promise<LedgerInfo[]>;
+    listLedgers(options?: ListLedgersOptions): Promise<LedgerInfo[]>;
     /**
      * Récupère un bloc par son ID.
      */
@@ -871,6 +889,11 @@ declare class PmsClient {
      *   after_ts: activity.next_after_ts,
      *   after_id: activity.next_after_id,
      * });
+     *
+     * // Avec déchiffrement des payloads chiffrés (TLS requis)
+     * const decrypted = await client.getActivity("8eabc...", {
+     *   x25519_sk_hex: wallet.x25519PrivateKeyHex,
+     * });
      * ```
      */
     getActivity(address: string, options?: ActivityOptions): Promise<ActivityResp>;
@@ -1070,4 +1093,4 @@ declare function formatAmount(sats: bigint): string;
  */
 declare function decryptPayload(encrypted: EncryptedPayload, recipientPrivateKeyHex: string): string;
 
-export { type ActivityDirection, type ActivityItem, type ActivityOptions, type ActivityResp, type ActivityType, type BalanceInfo, type Block, type BurnNftResponse, type CoordinatorInfoResponse, type CubeAttributes, type HistoryItem, type LedgerInfo, type MintCubeResponse, type NftMetadata, type NftResponse, PmsClient, type PmsClientConfig, PmsWallet, type PrepareTxRequest, type PrepareTxResponse, type RuntimeConfig, type StreamActivityOptions, type SubmitResponse, type SupplyInfo, type TokenMetadata, type Utxo, type UtxoDetail, type WalletHistoryResp, type WalletResponse, decryptPayload, formatAmount, fromHex, isValidMnemonic, parseAmount, toHex };
+export { type ActivityDirection, type ActivityItem, type ActivityOptions, type ActivityResp, type ActivityType, type BalanceInfo, type Block, type BurnNftResponse, type CoordinatorInfoResponse, type CubeAttributes, type HistoryItem, type LedgerInfo, type ListLedgersOptions, type MintCubeResponse, type NftMetadata, type NftResponse, PmsClient, type PmsClientConfig, PmsWallet, type PrepareTxRequest, type PrepareTxResponse, type RuntimeConfig, type StreamActivityOptions, type SubmitResponse, type SupplyInfo, type TokenMetadata, type Utxo, type UtxoDetail, type WalletHistoryResp, type WalletResponse, decryptPayload, formatAmount, fromHex, isValidMnemonic, parseAmount, toHex };

package/dist/index.d.ts

@@ -472,6 +472,8 @@ interface WalletResponse {
     public_key_hex: string;
     /** Clé publique X25519 (hex) */
     x25519_pub_hex: string;
+    /** Clé secrète X25519 (hex, dérivée via HKDF depuis la clé ECDSA) */
+    x25519_sk_hex: string;
     /** Mots mnémoniques (24 mots, absent si restauré depuis clé privée) */
     mnemonic_words?: string[];
 }
@@ -496,6 +498,13 @@ interface LedgerInfo {
     protocol_version: number;
     /** Nombre de blocs dans le DAG */
     block_count: number;
+    /** Symbole du token natif (ex: "PMS") */
+    symbol: string;
+}
+/** Options pour listLedgers() */
+interface ListLedgersOptions {
+    /** Filtre prefix (starts_with, case-insensitive) sur id, network_id ou symbol */
+    search?: string;
 }
 /** Configuration du client PMS */
 interface PmsClientConfig {
@@ -550,11 +559,12 @@ interface WalletHistoryResp {
  * - Minting: "mint"
  * - NFT: "nft_mint", "nft_transfer_in", "nft_transfer_out", "nft_burn", "nft_use"
  * - Bridge: "bridge_lock_in", "bridge_lock_out", "bridge_mint"
- * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reversed", "reverse_received"
+ * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reverse_received"
  * - Token: "token_create"
  * - Reward: "reward"
+ * - Encrypted: "encrypted" (payload chiffré sans clé de déchiffrement)
  */
-type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_lock_out" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reversed" | "reverse_received" | "token_create";
+type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reverse_received" | "token_create" | "encrypted";
 /** Direction de l'activité */
 type ActivityDirection = "in" | "out" | "info";
 /** Élément d'activité classifié pour un wallet */
@@ -597,7 +607,7 @@ interface ActivityResp {
 interface ActivityOptions {
     /** Filtrer par type(s) d'activité (ex: ["fee_received", "transfer_in"]) */
     type?: ActivityType[];
-    /** Nombre max d'éléments (défaut: 50, max: 500) */
+    /** Nombre max d'éléments (défaut: 50, max: 2000) */
     limit?: number;
     /** Cursor de pagination: timestamp */
     after_ts?: number;
@@ -605,11 +615,15 @@ interface ActivityOptions {
     after_id?: string;
     /** Filtrer par asset ID */
     asset_id?: string;
+    /** Clé privée X25519 (hex) pour déchiffrer les payloads chiffrés (EncryptedReward, Encrypted). Requiert TLS. */
+    x25519_sk_hex?: string;
 }
 /** Options pour streamActivity() */
 interface StreamActivityOptions {
     /** Filtrer par type(s) d'activité */
     type?: ActivityType[];
+    /** Clé privée X25519 (hex) pour déchiffrer les payloads chiffrés en temps réel. Requiert TLS. */
+    x25519_sk_hex?: string;
     /** Callback appelé pour chaque activité en temps réel */
     onActivity: (item: ActivityItem) => void;
     /** Callback appelé en cas d'erreur */
@@ -689,15 +703,19 @@ declare class PmsClient {
     /**
      * Liste tous les ledgers actifs avec leur nombre de blocs.
      *
+     * @param options - Filtrage optionnel
+     * @returns Ledgers correspondants
+     *
      * @example
      * ```typescript
+     * // Tous les ledgers
      * const ledgers = await client.listLedgers();
-     * for (const l of ledgers) {
-     *   console.log(`${l.id}: ${l.block_count} blocks`);
-     * }
+     *
+     * // Filtrer par préfixe de nom (starts_with, case-insensitive)
+     * const gaming = await client.listLedgers({ search: "gam" });
      * ```
      */
-    listLedgers(): Promise<LedgerInfo[]>;
+    listLedgers(options?: ListLedgersOptions): Promise<LedgerInfo[]>;
     /**
      * Récupère un bloc par son ID.
      */
@@ -871,6 +889,11 @@ declare class PmsClient {
      *   after_ts: activity.next_after_ts,
      *   after_id: activity.next_after_id,
      * });
+     *
+     * // Avec déchiffrement des payloads chiffrés (TLS requis)
+     * const decrypted = await client.getActivity("8eabc...", {
+     *   x25519_sk_hex: wallet.x25519PrivateKeyHex,
+     * });
      * ```
      */
     getActivity(address: string, options?: ActivityOptions): Promise<ActivityResp>;
@@ -1070,4 +1093,4 @@ declare function formatAmount(sats: bigint): string;
  */
 declare function decryptPayload(encrypted: EncryptedPayload, recipientPrivateKeyHex: string): string;
 
-export { type ActivityDirection, type ActivityItem, type ActivityOptions, type ActivityResp, type ActivityType, type BalanceInfo, type Block, type BurnNftResponse, type CoordinatorInfoResponse, type CubeAttributes, type HistoryItem, type LedgerInfo, type MintCubeResponse, type NftMetadata, type NftResponse, PmsClient, type PmsClientConfig, PmsWallet, type PrepareTxRequest, type PrepareTxResponse, type RuntimeConfig, type StreamActivityOptions, type SubmitResponse, type SupplyInfo, type TokenMetadata, type Utxo, type UtxoDetail, type WalletHistoryResp, type WalletResponse, decryptPayload, formatAmount, fromHex, isValidMnemonic, parseAmount, toHex };
+export { type ActivityDirection, type ActivityItem, type ActivityOptions, type ActivityResp, type ActivityType, type BalanceInfo, type Block, type BurnNftResponse, type CoordinatorInfoResponse, type CubeAttributes, type HistoryItem, type LedgerInfo, type ListLedgersOptions, type MintCubeResponse, type NftMetadata, type NftResponse, PmsClient, type PmsClientConfig, PmsWallet, type PrepareTxRequest, type PrepareTxResponse, type RuntimeConfig, type StreamActivityOptions, type SubmitResponse, type SupplyInfo, type TokenMetadata, type Utxo, type UtxoDetail, type WalletHistoryResp, type WalletResponse, decryptPayload, formatAmount, fromHex, isValidMnemonic, parseAmount, toHex };

package/dist/index.js

@@ -344,17 +344,26 @@ var PmsClient = class {
   /**
    * Liste tous les ledgers actifs avec leur nombre de blocs.
    *
+   * @param options - Filtrage optionnel
+   * @returns Ledgers correspondants
+   *
    * @example
    * ```typescript
+   * // Tous les ledgers
    * const ledgers = await client.listLedgers();
-   * for (const l of ledgers) {
-   *   console.log(`${l.id}: ${l.block_count} blocks`);
-   * }
+   *
+   * // Filtrer par préfixe de nom (starts_with, case-insensitive)
+   * const gaming = await client.listLedgers({ search: "gam" });
    * ```
    */
-  async listLedgers() {
-    const res = await this.fetch("/v1/ledgers");
-    return res.ledgers ?? [];
+  async listLedgers(options) {
+    const params = new URLSearchParams();
+    if (options?.search) {
+      params.set("search", options.search);
+    }
+    const qs = params.toString();
+    const path = `/v1/ledgers${qs ? `?${qs}` : ""}`;
+    return (await this.fetch(path)).ledgers ?? [];
   }
   /**
    * Récupère un bloc par son ID.
@@ -635,6 +644,11 @@ var PmsClient = class {
    *   after_ts: activity.next_after_ts,
    *   after_id: activity.next_after_id,
    * });
+   *
+   * // Avec déchiffrement des payloads chiffrés (TLS requis)
+   * const decrypted = await client.getActivity("8eabc...", {
+   *   x25519_sk_hex: wallet.x25519PrivateKeyHex,
+   * });
    * ```
    */
   async getActivity(address, options) {
@@ -654,6 +668,9 @@ var PmsClient = class {
     if (options?.asset_id !== void 0) {
       params.set("asset_id", options.asset_id);
     }
+    if (options?.x25519_sk_hex !== void 0) {
+      params.set("x25519_sk_hex", options.x25519_sk_hex);
+    }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity${qs ? `?${qs}` : ""}`;
     return this.fetch(path);
@@ -686,6 +703,9 @@ var PmsClient = class {
     if (options.type && options.type.length > 0) {
       params.set("type", options.type.join(","));
     }
+    if (options.x25519_sk_hex !== void 0) {
+      params.set("x25519_sk_hex", options.x25519_sk_hex);
+    }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity/stream${qs ? `?${qs}` : ""}`;
     const url = `${this.config.nodeUrl}${path}`;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@empereur-rouge/pms-sdk",
-    "version": "0.3.4",
+    "version": "0.3.6",
     "description": "TypeScript SDK for PMS (Planetary Monetary System) — wallet management, transactions, NFTs, and DAG interactions",
     "author": "empereur-rouge",
     "license": "MIT",