@empereur-rouge/pms-sdk 0.1.0 → 0.2.0

package/README.md

@@ -31,9 +31,10 @@ const wallet = PmsWallet.generate();
 console.log("Mnemonic:", wallet.mnemonic);
 console.log("Address:", wallet.address);
 
-// 2. Connecter au réseau
+// 2. Connecter au réseau (clé API obligatoire)
 const client = new PmsClient({ 
-  nodeUrl: "https://node.pms.network" 
+  nodeUrl: "https://node.pms.network",
+  apiKey: "pk_live_votre_cle_ici",
 });
 
 // 3. Consulter la balance
@@ -116,6 +117,7 @@ Le client permet d'interagir avec l'API REST des nœuds PMS.
 ```typescript
 const client = new PmsClient({
   nodeUrl: "https://node.pms.network",  // URL du nœud principal
+  apiKey: "pk_live_votre_cle_ici",       // Clé API (obligatoire)
   seedNodes: [                           // Optionnel: nœuds de secours
     "https://node2.pms.network",
     "https://node3.pms.network",
@@ -127,6 +129,9 @@ const client = new PmsClient({
 });
 ```
 
+> [!IMPORTANT]
+> La clé API est **obligatoire**. Obtenez-la depuis votre dashboard PMS ou auprès de l'administrateur du réseau.
+
 #### Méthodes de Lecture
 
 ```typescript
@@ -480,6 +485,7 @@ Cela améliore :
 // Désactiver si non souhaité
 const client = new PmsClient({
   nodeUrl: "...",
+  apiKey: "pk_live_...",
   enableRacing: false,
 });
 ```

package/dist/index.cjs

@@ -331,6 +331,11 @@ var PmsClient = class {
    * @param config.seedNodes - Liste des nœuds de seed
    */
   constructor(config) {
+    if (!config.apiKey || config.apiKey.trim() === "") {
+      throw new Error(
+        "PmsClient requires an API key. Get yours at https://dashboard.pms.network or contact your administrator. Usage: new PmsClient({ nodeUrl: '...', apiKey: 'pk_live_...' })"
+      );
+    }
     this.config = {
       ...DEFAULT_CONFIG,
       seedNodes: config.seedNodes ?? [],
@@ -1027,6 +1032,9 @@ var PmsClient = class {
         ...init,
         headers: {
           "Content-Type": "application/json",
+          // Injection automatique de la clé API dans chaque requête.
+          // Le serveur PMS vérifie ce header pour autoriser l'accès.
+          "X-API-Key": this.config.apiKey,
           ...init?.headers
         },
         signal

package/dist/index.d.cts

@@ -473,6 +473,14 @@ interface BalanceInfo {
 interface PmsClientConfig {
     /** URL du nœud principal (ex: "https://node.pms.network") */
     nodeUrl: string;
+    /**
+     * Clé d'API pour authentifier les requêtes.
+     * Obligatoire pour accéder à l'API PMS.
+     * Obtenue depuis le dashboard PMS ou fournie par l'administrateur.
+     *
+     * Exemple: "pk_live_abc123..." ou "pk_test_xyz789..."
+     */
+    apiKey: string;
     /** URLs des noeuds seeds (optionnel, pour racing et fallback) */
     seedNodes?: string[];
     /** ID du réseau (défaut: "pms-mainnet") */

package/dist/index.d.ts

@@ -473,6 +473,14 @@ interface BalanceInfo {
 interface PmsClientConfig {
     /** URL du nœud principal (ex: "https://node.pms.network") */
     nodeUrl: string;
+    /**
+     * Clé d'API pour authentifier les requêtes.
+     * Obligatoire pour accéder à l'API PMS.
+     * Obtenue depuis le dashboard PMS ou fournie par l'administrateur.
+     *
+     * Exemple: "pk_live_abc123..." ou "pk_test_xyz789..."
+     */
+    apiKey: string;
     /** URLs des noeuds seeds (optionnel, pour racing et fallback) */
     seedNodes?: string[];
     /** ID du réseau (défaut: "pms-mainnet") */

package/dist/index.js

@@ -298,6 +298,11 @@ var PmsClient = class {
    * @param config.seedNodes - Liste des nœuds de seed
    */
   constructor(config) {
+    if (!config.apiKey || config.apiKey.trim() === "") {
+      throw new Error(
+        "PmsClient requires an API key. Get yours at https://dashboard.pms.network or contact your administrator. Usage: new PmsClient({ nodeUrl: '...', apiKey: 'pk_live_...' })"
+      );
+    }
     this.config = {
       ...DEFAULT_CONFIG,
       seedNodes: config.seedNodes ?? [],
@@ -994,6 +999,9 @@ var PmsClient = class {
         ...init,
         headers: {
           "Content-Type": "application/json",
+          // Injection automatique de la clé API dans chaque requête.
+          // Le serveur PMS vérifie ce header pour autoriser l'accès.
+          "X-API-Key": this.config.apiKey,
           ...init?.headers
         },
         signal

package/package.json

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