@empereur-rouge/pms-sdk 0.3.4 → 0.3.5

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

@@ -496,6 +496,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 {
@@ -605,11 +612,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 +700,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 +886,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 +1090,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

@@ -496,6 +496,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 {
@@ -605,11 +612,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 +700,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 +886,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 +1090,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.5",
     "description": "TypeScript SDK for PMS (Planetary Monetary System) — wallet management, transactions, NFTs, and DAG interactions",
     "author": "empereur-rouge",
     "license": "MIT",