@empereur-rouge/pms-sdk 0.3.2 → 0.3.4

package/README.md

@@ -171,6 +171,16 @@ console.log(imported.address); // même adresse que ci-dessus
 
 #### Méthodes de Lecture
 
+```typescript
+// Lister les ledgers actifs (avec block_count 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 }
+// ]
+```
+
 ```typescript
 // Récupérer les tips du DAG (blocs les plus récents)
 const tips: string[] = await client.getTips();
@@ -455,10 +465,13 @@ import type {
   // Blocs & Transactions (lecture)
   Block,
   Utxo,
-  
+
   // Historique
   WalletHistoryResp,
   HistoryItem,
+
+  // Ledger
+  LedgerInfo,
 } from "@empereur-rouge/pms-sdk";
 
 // Types bas niveau (API avancée)

package/dist/index.cjs

@@ -374,6 +374,21 @@ var PmsClient = class {
   async getCoordinatorInfo() {
     return this.fetch("/v1/coordinator/info");
   }
+  /**
+   * Liste tous les ledgers actifs avec leur nombre de blocs.
+   *
+   * @example
+   * ```typescript
+   * const ledgers = await client.listLedgers();
+   * for (const l of ledgers) {
+   *   console.log(`${l.id}: ${l.block_count} blocks`);
+   * }
+   * ```
+   */
+  async listLedgers() {
+    const res = await this.fetch("/v1/ledgers");
+    return res.ledgers ?? [];
+  }
   /**
    * Récupère un bloc par son ID.
    */

package/dist/index.d.cts

@@ -484,6 +484,19 @@ interface BalanceInfo {
     /** Liste des UTXOs */
     utxos: Utxo[];
 }
+/** Info sur un ledger actif */
+interface LedgerInfo {
+    /** Identifiant unique du ledger */
+    id: string;
+    /** Network ID du ledger */
+    network_id: string;
+    /** Préfixe de stockage */
+    prefix: string;
+    /** Version du protocole */
+    protocol_version: number;
+    /** Nombre de blocs dans le DAG */
+    block_count: number;
+}
 /** Configuration du client PMS */
 interface PmsClientConfig {
     /** URL du nœud principal (ex: "https://node.pms.network") */
@@ -560,6 +573,8 @@ interface ActivityItem {
     asset_id?: string;
     /** Adresse de la contrepartie */
     counterparty?: string;
+    /** Ledger ID d'origine (absent en mode single-ledger "main") */
+    ledger_id?: string;
     /** Payload brut pour détails complets */
     payload: any;
 }
@@ -671,6 +686,18 @@ declare class PmsClient {
      * Récupère les informations publiques du coordinateur (clés).
      */
     getCoordinatorInfo(): Promise<CoordinatorInfoResponse>;
+    /**
+     * Liste tous les ledgers actifs avec leur nombre de blocs.
+     *
+     * @example
+     * ```typescript
+     * const ledgers = await client.listLedgers();
+     * for (const l of ledgers) {
+     *   console.log(`${l.id}: ${l.block_count} blocks`);
+     * }
+     * ```
+     */
+    listLedgers(): Promise<LedgerInfo[]>;
     /**
      * Récupère un bloc par son ID.
      */
@@ -1043,4 +1070,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 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 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

@@ -484,6 +484,19 @@ interface BalanceInfo {
     /** Liste des UTXOs */
     utxos: Utxo[];
 }
+/** Info sur un ledger actif */
+interface LedgerInfo {
+    /** Identifiant unique du ledger */
+    id: string;
+    /** Network ID du ledger */
+    network_id: string;
+    /** Préfixe de stockage */
+    prefix: string;
+    /** Version du protocole */
+    protocol_version: number;
+    /** Nombre de blocs dans le DAG */
+    block_count: number;
+}
 /** Configuration du client PMS */
 interface PmsClientConfig {
     /** URL du nœud principal (ex: "https://node.pms.network") */
@@ -560,6 +573,8 @@ interface ActivityItem {
     asset_id?: string;
     /** Adresse de la contrepartie */
     counterparty?: string;
+    /** Ledger ID d'origine (absent en mode single-ledger "main") */
+    ledger_id?: string;
     /** Payload brut pour détails complets */
     payload: any;
 }
@@ -671,6 +686,18 @@ declare class PmsClient {
      * Récupère les informations publiques du coordinateur (clés).
      */
     getCoordinatorInfo(): Promise<CoordinatorInfoResponse>;
+    /**
+     * Liste tous les ledgers actifs avec leur nombre de blocs.
+     *
+     * @example
+     * ```typescript
+     * const ledgers = await client.listLedgers();
+     * for (const l of ledgers) {
+     *   console.log(`${l.id}: ${l.block_count} blocks`);
+     * }
+     * ```
+     */
+    listLedgers(): Promise<LedgerInfo[]>;
     /**
      * Récupère un bloc par son ID.
      */
@@ -1043,4 +1070,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 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 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

@@ -341,6 +341,21 @@ var PmsClient = class {
   async getCoordinatorInfo() {
     return this.fetch("/v1/coordinator/info");
   }
+  /**
+   * Liste tous les ledgers actifs avec leur nombre de blocs.
+   *
+   * @example
+   * ```typescript
+   * const ledgers = await client.listLedgers();
+   * for (const l of ledgers) {
+   *   console.log(`${l.id}: ${l.block_count} blocks`);
+   * }
+   * ```
+   */
+  async listLedgers() {
+    const res = await this.fetch("/v1/ledgers");
+    return res.ledgers ?? [];
+  }
   /**
    * Récupère un bloc par son ID.
    */

package/package.json

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