@fairmint/canton-node-sdk 0.0.118 → 0.0.119

package/build/src/utils/index.d.ts

@@ -3,5 +3,6 @@ export * from './contracts';
 export * from './mining';
 export * from './parsers';
 export * from './party';
+export * from './privy';
 export * from './transactions';
 //# sourceMappingURL=index.d.ts.map

package/build/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/build/src/utils/index.js

@@ -19,5 +19,6 @@ __exportStar(require("./contracts"), exports);
 __exportStar(require("./mining"), exports);
 __exportStar(require("./parsers"), exports);
 __exportStar(require("./party"), exports);
+__exportStar(require("./privy"), exports);
 __exportStar(require("./transactions"), exports);
 //# sourceMappingURL=index.js.map

package/build/src/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,iDAA+B"}

package/build/src/utils/privy/client.d.ts

@@ -0,0 +1,36 @@
+import { PrivyClient } from '@privy-io/node';
+import type { PrivyClientOptions } from './types';
+/**
+ * Creates a Privy client instance for wallet operations
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *   ```;
+ *
+ * @param options - Configuration options for the Privy client
+ * @returns Configured PrivyClient instance
+ * @throws Error if appId or appSecret are missing
+ */
+export declare function createPrivyClient(options: PrivyClientOptions): PrivyClient;
+/**
+ * Creates a Privy client from environment variables
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClientFromEnv } from '@fairmint/canton-node-sdk';
+ *
+ *   // Requires PRIVY_APP_ID and PRIVY_APP_SECRET in environment
+ *   const privy = createPrivyClientFromEnv();
+ *   ```;
+ *
+ * @returns Configured PrivyClient instance
+ * @throws Error if PRIVY_APP_ID or PRIVY_APP_SECRET are not set
+ */
+export declare function createPrivyClientFromEnv(): PrivyClient;
+//# sourceMappingURL=client.d.ts.map

package/build/src/utils/privy/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAiB1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAKtD"}

package/build/src/utils/privy/client.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrivyClient = createPrivyClient;
+exports.createPrivyClientFromEnv = createPrivyClientFromEnv;
+const node_1 = require("@privy-io/node");
+/**
+ * Creates a Privy client instance for wallet operations
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *   ```;
+ *
+ * @param options - Configuration options for the Privy client
+ * @returns Configured PrivyClient instance
+ * @throws Error if appId or appSecret are missing
+ */
+function createPrivyClient(options) {
+    const { appId, appSecret } = options;
+    if (!appId) {
+        throw new Error('Privy App ID is required. Set PRIVY_APP_ID environment variable or provide appId option.');
+    }
+    if (!appSecret) {
+        throw new Error('Privy App Secret is required. Set PRIVY_APP_SECRET environment variable or provide appSecret option.');
+    }
+    return new node_1.PrivyClient({
+        appId,
+        appSecret,
+    });
+}
+/**
+ * Creates a Privy client from environment variables
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClientFromEnv } from '@fairmint/canton-node-sdk';
+ *
+ *   // Requires PRIVY_APP_ID and PRIVY_APP_SECRET in environment
+ *   const privy = createPrivyClientFromEnv();
+ *   ```;
+ *
+ * @returns Configured PrivyClient instance
+ * @throws Error if PRIVY_APP_ID or PRIVY_APP_SECRET are not set
+ */
+function createPrivyClientFromEnv() {
+    return createPrivyClient({
+        appId: process.env['PRIVY_APP_ID'] ?? '',
+        appSecret: process.env['PRIVY_APP_SECRET'] ?? '',
+    });
+}
+//# sourceMappingURL=client.js.map

package/build/src/utils/privy/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/utils/privy/client.ts"],"names":[],"mappings":";;AAoBA,8CAiBC;AAgBD,4DAKC;AA1DD,yCAA6C;AAG7C;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAErC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC9G,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,kBAAW,CAAC;QACrB,KAAK;QACL,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,wBAAwB;IACtC,OAAO,iBAAiB,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;QACxC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE;KACjD,CAAC,CAAC;AACL,CAAC"}

package/build/src/utils/privy/createWallet.d.ts

@@ -0,0 +1,30 @@
+import type { PrivyClient } from '@privy-io/node';
+import type { CreateStellarWalletOptions, StellarWallet } from './types';
+/**
+ * Creates a new Stellar wallet using Privy
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, createStellarWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   // Create unlinked wallet
+ *   const wallet = await createStellarWallet(privy);
+ *
+ *   // Create wallet linked to a user
+ *   const userWallet = await createStellarWallet(privy, {
+ *     userId: 'did:privy:...'
+ *   });
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param options - Optional configuration for wallet creation
+ * @returns Promise resolving to the created Stellar wallet information
+ * @throws Error if wallet creation fails or userId format is invalid
+ */
+export declare function createStellarWallet(privyClient: PrivyClient, options?: CreateStellarWalletOptions): Promise<StellarWallet>;
+//# sourceMappingURL=createWallet.d.ts.map

package/build/src/utils/privy/createWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWallet.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/createWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,aAAa,CAAC,CAsCxB"}

package/build/src/utils/privy/createWallet.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStellarWallet = createStellarWallet;
+const stellar_base_1 = require("@stellar/stellar-base");
+/**
+ * Creates a new Stellar wallet using Privy
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, createStellarWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   // Create unlinked wallet
+ *   const wallet = await createStellarWallet(privy);
+ *
+ *   // Create wallet linked to a user
+ *   const userWallet = await createStellarWallet(privy, {
+ *     userId: 'did:privy:...'
+ *   });
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param options - Optional configuration for wallet creation
+ * @returns Promise resolving to the created Stellar wallet information
+ * @throws Error if wallet creation fails or userId format is invalid
+ */
+async function createStellarWallet(privyClient, options) {
+    // Validate userId format if provided
+    if (options?.userId && !options.userId.startsWith('did:privy:')) {
+        throw new Error(`Invalid user ID format. User ID must start with "did:privy:", got: ${options.userId}`);
+    }
+    // Create wallet request
+    const createRequest = {
+        chain_type: 'stellar',
+    };
+    if (options?.userId) {
+        createRequest.owner = { user_id: options.userId };
+    }
+    // Create the wallet
+    const privyWallet = await privyClient.wallets().create(createRequest);
+    // Decode Stellar address to get base64 public key
+    const rawPublicKey = stellar_base_1.StrKey.decodeEd25519PublicKey(privyWallet.address);
+    const publicKeyBase64 = Buffer.from(rawPublicKey).toString('base64');
+    // Safely access owner property that may not be in type definitions
+    const { owner } = privyWallet;
+    const result = {
+        id: privyWallet.id,
+        address: privyWallet.address,
+        chain_type: 'stellar',
+        publicKeyBase64,
+    };
+    // Only include owner if it exists (for exactOptionalPropertyTypes compliance)
+    if (owner) {
+        result.owner = owner;
+    }
+    return result;
+}
+//# sourceMappingURL=createWallet.js.map

package/build/src/utils/privy/createWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWallet.js","sourceRoot":"","sources":["../../../../src/utils/privy/createWallet.ts"],"names":[],"mappings":";;AA8BA,kDAyCC;AAtED,wDAA+C;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,mBAAmB,CACvC,WAAwB,EACxB,OAAoC;IAEpC,qCAAqC;IACrC,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,sEAAsE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,wBAAwB;IACxB,MAAM,aAAa,GAA2D;QAC5E,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,aAAa,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAEtE,kDAAkD;IAClD,MAAM,YAAY,GAAG,qBAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErE,mEAAmE;IACnE,MAAM,EAAE,KAAK,EAAE,GAAG,WAA8C,CAAC;IAEjE,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,SAAS;QACrB,eAAe;KAChB,CAAC;IAEF,8EAA8E;IAC9E,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/src/utils/privy/getWallet.d.ts

@@ -0,0 +1,25 @@
+import type { PrivyClient } from '@privy-io/node';
+import type { StellarWallet } from './types';
+/**
+ * Retrieves an existing Stellar wallet from Privy by wallet ID
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, getStellarWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   const wallet = await getStellarWallet(privy, 'wallet-id-here');
+ *   console.log('Wallet address:', wallet.address);
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param walletId - The wallet ID to retrieve
+ * @returns Promise resolving to the Stellar wallet information
+ * @throws Error if wallet is not found or is not a Stellar wallet
+ */
+export declare function getStellarWallet(privyClient: PrivyClient, walletId: string): Promise<StellarWallet>;
+//# sourceMappingURL=getWallet.d.ts.map

package/build/src/utils/privy/getWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWallet.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/getWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BzG"}

package/build/src/utils/privy/getWallet.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStellarWallet = getStellarWallet;
+const stellar_base_1 = require("@stellar/stellar-base");
+/**
+ * Retrieves an existing Stellar wallet from Privy by wallet ID
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, getStellarWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   const wallet = await getStellarWallet(privy, 'wallet-id-here');
+ *   console.log('Wallet address:', wallet.address);
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param walletId - The wallet ID to retrieve
+ * @returns Promise resolving to the Stellar wallet information
+ * @throws Error if wallet is not found or is not a Stellar wallet
+ */
+async function getStellarWallet(privyClient, walletId) {
+    // Get the wallet from Privy
+    const privyWallet = await privyClient.wallets().get(walletId);
+    // Verify it's a Stellar wallet
+    if (privyWallet.chain_type !== 'stellar') {
+        throw new Error(`Wallet ${walletId} is not a Stellar wallet. Found chain_type: ${privyWallet.chain_type}`);
+    }
+    // Decode Stellar address to get base64 public key
+    const rawPublicKey = stellar_base_1.StrKey.decodeEd25519PublicKey(privyWallet.address);
+    const publicKeyBase64 = Buffer.from(rawPublicKey).toString('base64');
+    // Safely access owner property that may not be in type definitions
+    const { owner } = privyWallet;
+    const result = {
+        id: privyWallet.id,
+        address: privyWallet.address,
+        chain_type: 'stellar',
+        publicKeyBase64,
+    };
+    // Only include owner if it exists (for exactOptionalPropertyTypes compliance)
+    if (owner) {
+        result.owner = owner;
+    }
+    return result;
+}
+//# sourceMappingURL=getWallet.js.map

package/build/src/utils/privy/getWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWallet.js","sourceRoot":"","sources":["../../../../src/utils/privy/getWallet.ts"],"names":[],"mappings":";;AAyBA,4CA6BC;AArDD,wDAA+C;AAG/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,gBAAgB,CAAC,WAAwB,EAAE,QAAgB;IAC/E,4BAA4B;IAC5B,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE9D,+BAA+B;IAC/B,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,+CAA+C,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,kDAAkD;IAClD,MAAM,YAAY,GAAG,qBAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErE,mEAAmE;IACnE,MAAM,EAAE,KAAK,EAAE,GAAG,WAA8C,CAAC;IAEjE,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,SAAS;QACrB,eAAe;KAChB,CAAC;IAEF,8EAA8E;IAC9E,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/src/utils/privy/index.d.ts

@@ -0,0 +1,6 @@
+export * from './client';
+export * from './createWallet';
+export * from './getWallet';
+export * from './signData';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/src/utils/privy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/build/src/utils/privy/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client"), exports);
+__exportStar(require("./createWallet"), exports);
+__exportStar(require("./getWallet"), exports);
+__exportStar(require("./signData"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/build/src/utils/privy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/privy/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB"}

package/build/src/utils/privy/signData.d.ts

@@ -0,0 +1,34 @@
+import type { PrivyClient } from '@privy-io/node';
+import type { SignOptions, SignResult } from './types';
+/**
+ * Signs data using a Stellar wallet managed by Privy
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, signWithWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   // Sign a hex string
+ *   const result = await signWithWallet(privy, {
+ *     walletId: 'wallet-id-here',
+ *     data: 'deadbeef'
+ *   });
+ *
+ *   // Sign a Buffer
+ *   const bufferResult = await signWithWallet(privy, {
+ *     walletId: 'wallet-id-here',
+ *     data: Buffer.from('test message')
+ *   });
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param options - Signing options including wallet ID and data
+ * @returns Promise resolving to the signature result
+ * @throws Error if signing fails
+ */
+export declare function signWithWallet(privyClient: PrivyClient, options: SignOptions): Promise<SignResult>;
+//# sourceMappingURL=signData.d.ts.map

package/build/src/utils/privy/signData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signData.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/signData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+BxG"}

package/build/src/utils/privy/signData.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signWithWallet = signWithWallet;
+/**
+ * Signs data using a Stellar wallet managed by Privy
+ *
+ * @example
+ *   ```typescript
+ *   import { createPrivyClient, signWithWallet } from '@fairmint/canton-node-sdk';
+ *
+ *   const privy = createPrivyClient({
+ *     appId: process.env.PRIVY_APP_ID!,
+ *     appSecret: process.env.PRIVY_APP_SECRET!
+ *   });
+ *
+ *   // Sign a hex string
+ *   const result = await signWithWallet(privy, {
+ *     walletId: 'wallet-id-here',
+ *     data: 'deadbeef'
+ *   });
+ *
+ *   // Sign a Buffer
+ *   const bufferResult = await signWithWallet(privy, {
+ *     walletId: 'wallet-id-here',
+ *     data: Buffer.from('test message')
+ *   });
+ *   ```;
+ *
+ * @param privyClient - Configured Privy client instance
+ * @param options - Signing options including wallet ID and data
+ * @returns Promise resolving to the signature result
+ * @throws Error if signing fails
+ */
+async function signWithWallet(privyClient, options) {
+    const { walletId, data } = options;
+    // Convert data to hex if it's a Buffer
+    let hexData;
+    if (Buffer.isBuffer(data)) {
+        hexData = data.toString('hex');
+    }
+    else {
+        // Remove 0x prefix if present
+        hexData = data.startsWith('0x') ? data.slice(2) : data;
+    }
+    // Validate hex string
+    if (!/^[0-9a-fA-F]*$/.test(hexData)) {
+        throw new Error(`Invalid hex data: ${hexData}`);
+    }
+    // Sign using Privy's rawSign API
+    const { signature, encoding } = await privyClient.wallets().rawSign(walletId, {
+        params: { hash: `0x${hexData}` },
+    });
+    // Remove 0x prefix and convert to base64
+    const signatureHex = signature.startsWith('0x') ? signature.slice(2) : signature;
+    const signatureBase64 = Buffer.from(signatureHex, 'hex').toString('base64');
+    return {
+        signature,
+        encoding,
+        signatureBase64,
+    };
+}
+//# sourceMappingURL=signData.js.map

package/build/src/utils/privy/signData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signData.js","sourceRoot":"","sources":["../../../../src/utils/privy/signData.ts"],"names":[],"mappings":";;AAiCA,wCA+BC;AA7DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACI,KAAK,UAAU,cAAc,CAAC,WAAwB,EAAE,OAAoB;IACjF,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEnC,uCAAuC;IACvC,IAAI,OAAe,CAAC;IACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,8BAA8B;QAC9B,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,iCAAiC;IACjC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC5E,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,EAAE;KACjC,CAAC,CAAC;IAEH,yCAAyC;IACzC,MAAM,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE5E,OAAO;QACL,SAAS;QACT,QAAQ;QACR,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/build/src/utils/privy/types.d.ts

@@ -0,0 +1,45 @@
+/** Privy wallet types and interfaces */
+/** Options for creating a Privy client */
+export interface PrivyClientOptions {
+    /** Privy App ID from environment variables or provided directly */
+    appId: string;
+    /** Privy App Secret from environment variables or provided directly */
+    appSecret: string;
+}
+/** Options for creating a Stellar wallet */
+export interface CreateStellarWalletOptions {
+    /** Optional user ID to link the wallet to (format: did:privy:...) */
+    userId?: string;
+}
+/** Stellar wallet information returned from Privy */
+export interface StellarWallet {
+    /** Wallet ID (used for signing operations) */
+    id: string;
+    /** Stellar public address */
+    address: string;
+    /** Chain type (always 'stellar' for Stellar wallets) */
+    chain_type: 'stellar';
+    /** Owner information if wallet is linked to a user */
+    owner?: {
+        user_id: string;
+    };
+    /** Base64 encoded public key (derived from address) */
+    publicKeyBase64: string;
+}
+/** Options for signing data with a Stellar wallet */
+export interface SignOptions {
+    /** Wallet ID to use for signing */
+    walletId: string;
+    /** Data to sign (will be hex encoded if not already) */
+    data: string | Buffer;
+}
+/** Result of a signing operation */
+export interface SignResult {
+    /** Signature in hex format (with 0x prefix) */
+    signature: string;
+    /** Signature encoding format */
+    encoding: string;
+    /** Signature in base64 format */
+    signatureBase64: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/utils/privy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/privy/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,UAAU,EAAE,SAAS,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/build/src/utils/privy/types.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Privy wallet types and interfaces */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/src/utils/privy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/privy/types.ts"],"names":[],"mappings":";AAAA,wCAAwC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/canton-node-sdk",
-  "version": "0.0.118",
+  "version": "0.0.119",
   "description": "Canton Node SDK",
   "keywords": [
     "canton",
@@ -55,6 +55,8 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
+    "@privy-io/node": "^0.3.0",
+    "@stellar/stellar-base": "^14.0.1",
     "axios": "1.12.2",
     "dotenv": "17.2.3",
     "glob": "11.0.3",