@trufnetwork/sdk-js 0.4.10 → 0.5.0

package/dist/types/contracts-api/attestationAction.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Attestation action implementation
+ *
+ * This module provides methods for requesting, retrieving, and listing attestations.
+ * Attestations are cryptographically signed proofs of query results that can be
+ * consumed by smart contracts and external applications.
+ */
+import { Action } from './action';
+import { RequestAttestationInput, RequestAttestationResult, GetSignedAttestationInput, SignedAttestationResult, ListAttestationsInput, AttestationMetadata } from '../types/attestation';
+/**
+ * AttestationAction provides methods for working with data attestations
+ *
+ * Attestations enable validators to cryptographically sign query results,
+ * providing verifiable proofs that can be used in smart contracts.
+ *
+ * @example
+ * ```typescript
+ * const client = new NodeTNClient({ ... });
+ * const attestationAction = client.loadAttestationAction();
+ *
+ * // Request an attestation
+ * const result = await attestationAction.requestAttestation({
+ *   dataProvider: "0x4710a8d8f0d845da110086812a32de6d90d7ff5c",
+ *   streamId: "stai0000000000000000000000000000",
+ *   actionName: "get_record",
+ *   args: [dataProvider, streamId, fromTime, toTime, null, false],
+ *   encryptSig: false,
+ *   maxFee: 1000000,
+ * });
+ *
+ * // Wait for signing (1-2 blocks)
+ * await new Promise(resolve => setTimeout(resolve, 10000));
+ *
+ * // Retrieve signed attestation
+ * const signed = await attestationAction.getSignedAttestation({
+ *   requestTxId: result.requestTxId,
+ * });
+ * ```
+ */
+export declare class AttestationAction extends Action {
+    /**
+     * Request a signed attestation of query results
+     *
+     * This submits a transaction requesting that validators execute a query
+     * and sign the results. The leader validator will sign the attestation
+     * asynchronously (typically 1-2 blocks later).
+     *
+     * @param input - Attestation request parameters
+     * @returns Promise resolving to request result with transaction ID
+     * @throws Error if validation fails or transaction fails
+     *
+     * @example
+     * ```typescript
+     * const result = await attestationAction.requestAttestation({
+     *   dataProvider: "0x4710a8d8f0d845da110086812a32de6d90d7ff5c",
+     *   streamId: "stai0000000000000000000000000000",
+     *   actionName: "get_record",
+     *   args: [
+     *     "0x4710a8d8f0d845da110086812a32de6d90d7ff5c",
+     *     "stai0000000000000000000000000000",
+     *     Math.floor(Date.now() / 1000) - 86400, // 1 day ago
+     *     Math.floor(Date.now() / 1000),
+     *     null,
+     *     false,
+     *   ],
+     *   encryptSig: false,
+     *   maxFee: 1000000,
+     * });
+     * console.log(`Request TX ID: ${result.requestTxId}`);
+     * ```
+     */
+    requestAttestation(input: RequestAttestationInput): Promise<RequestAttestationResult>;
+    /**
+     * Retrieve a complete signed attestation payload
+     *
+     * This fetches the signed attestation payload for a given request transaction ID.
+     * The attestation must have been signed by the leader validator first.
+     *
+     * If the attestation is not yet signed, this will throw an error. Clients should
+     * poll with exponential backoff or wait for 1-2 blocks after requesting.
+     *
+     * @param input - Request transaction ID
+     * @returns Promise resolving to signed attestation payload
+     * @throws Error if attestation not found or not yet signed
+     *
+     * @example
+     * ```typescript
+     * // Poll for signature
+     * for (let i = 0; i < 15; i++) {
+     *   try {
+     *     const signed = await attestationAction.getSignedAttestation({
+     *       requestTxId: "0x123...",
+     *     });
+     *     console.log(`Payload: ${Buffer.from(signed.payload).toString('hex')}`);
+     *     break;
+     *   } catch (e) {
+     *     await new Promise(resolve => setTimeout(resolve, 2000));
+     *   }
+     * }
+     * ```
+     */
+    getSignedAttestation(input: GetSignedAttestationInput): Promise<SignedAttestationResult>;
+    /**
+     * List attestation metadata with optional filtering
+     *
+     * This returns metadata for attestations, optionally filtered by requester address.
+     * Supports pagination and sorting.
+     *
+     * @param input - Filter and pagination parameters
+     * @returns Promise resolving to array of attestation metadata
+     * @throws Error if parameters are invalid
+     *
+     * @example
+     * ```typescript
+     * // List my recent attestations
+     * const myAddress = new Uint8Array(Buffer.from(wallet.address.slice(2), 'hex'));
+     * const attestations = await attestationAction.listAttestations({
+     *   requester: myAddress,
+     *   limit: 10,
+     *   offset: 0,
+     *   orderBy: "created_height desc",
+     * });
+     *
+     * attestations.forEach(att => {
+     *   console.log(`TX: ${att.requestTxId}, Height: ${att.createdHeight}`);
+     * });
+     * ```
+     */
+    listAttestations(input: ListAttestationsInput): Promise<AttestationMetadata[]>;
+}
+//# sourceMappingURL=attestationAction.d.ts.map

package/dist/types/contracts-api/attestationAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestationAction.d.ts","sourceRoot":"","sources":["../../../src/contracts-api/attestationAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EAGpB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,iBAAkB,SAAQ,MAAM;IAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,kBAAkB,CACtB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,oBAAoB,CACxB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;IA2DnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,gBAAgB,CACpB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAqClC"}

package/dist/types/index.common.d.ts

@@ -15,4 +15,6 @@ export { PrimitiveAction } from "./contracts-api/primitiveAction";
 export { ComposedAction } from "./contracts-api/composedAction";
 export { RoleManagement } from "./contracts-api/roleManagement";
 export type { GrantRoleInput, RevokeRoleInput, AreMembersOfInput, WalletMembership } from "./types/role";
+export { AttestationAction } from "./contracts-api/attestationAction";
+export type { RequestAttestationInput, RequestAttestationResult, GetSignedAttestationInput, SignedAttestationResult, ListAttestationsInput, AttestationMetadata } from "./types/attestation";
 //# sourceMappingURL=index.common.d.ts.map

package/dist/types/index.common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.common.d.ts","sourceRoot":"","sources":["../../src/index.common.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGjE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGlK,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.common.d.ts","sourceRoot":"","sources":["../../src/index.common.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGjE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGlK,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC"}

package/dist/types/internal.d.ts

@@ -8,6 +8,7 @@ export { Action } from "./contracts-api/action";
 export { PrimitiveAction } from "./contracts-api/primitiveAction";
 export { ComposedAction } from "./contracts-api/composedAction";
 export { RoleManagement } from "./contracts-api/roleManagement";
+export { AttestationAction } from "./contracts-api/attestationAction";
 export { deployStream } from "./contracts-api/deployStream";
 export { deleteStream } from "./contracts-api/deleteStream";
 export { StreamId } from "./util/StreamId";
@@ -19,5 +20,6 @@ export type { StreamRecord, ListMetadataByHeightParams, MetadataQueryResult, Get
 export type { InsertRecordInput } from "./contracts-api/primitiveAction";
 export type { TaxonomySet, TaxonomyItem, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from "./contracts-api/composedAction";
 export type { GrantRoleInput, RevokeRoleInput, AreMembersOfInput, WalletMembership } from "./types/role";
+export type { RequestAttestationInput, RequestAttestationResult, GetSignedAttestationInput, SignedAttestationResult, ListAttestationsInput, AttestationMetadata } from "./types/attestation";
 export type { VisibilityEnum } from "./util/visibility";
 //# sourceMappingURL=internal.d.ts.map

package/dist/types/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,4BAA4B,EAC5B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,4BAA4B,EAC5B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/types/attestation.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Type definitions for attestation operations
+ *
+ * Attestations enable validators to cryptographically sign query results,
+ * providing verifiable proofs that can be consumed by smart contracts and
+ * external applications.
+ */
+/**
+ * Input parameters for requesting an attestation
+ */
+export interface RequestAttestationInput {
+    /**
+     * Data provider address (0x-prefixed, 42 characters)
+     * Example: "0x4710a8d8f0d845da110086812a32de6d90d7ff5c"
+     */
+    dataProvider: string;
+    /**
+     * Stream ID (32 characters)
+     * Example: "stai0000000000000000000000000000"
+     */
+    streamId: string;
+    /**
+     * Action name to attest (must be in allowlist)
+     * Example: "get_record", "get_index"
+     */
+    actionName: string;
+    /**
+     * Action arguments (will be encoded)
+     * Must match the signature of the action
+     */
+    args: any[];
+    /**
+     * Whether to encrypt the signature (must be false in MVP)
+     * Future: ECIES encryption to requester's public key
+     */
+    encryptSig: boolean;
+    /**
+     * Maximum fee willing to pay (in smallest token unit)
+     * Transaction will abort if actual fee exceeds this
+     */
+    maxFee: number;
+}
+/**
+ * Result of requesting an attestation
+ */
+export interface RequestAttestationResult {
+    /**
+     * Transaction ID for this attestation request
+     * Use this to retrieve the signed attestation later
+     */
+    requestTxId: string;
+}
+/**
+ * Input parameters for retrieving a signed attestation
+ */
+export interface GetSignedAttestationInput {
+    /**
+     * Transaction ID from request_attestation
+     */
+    requestTxId: string;
+}
+/**
+ * Result of retrieving a signed attestation
+ */
+export interface SignedAttestationResult {
+    /**
+     * Complete attestation payload: canonical (8 fields) + signature
+     *
+     * Format: version | algo | height | provider | stream | action | args | result | signature
+     *
+     * This payload can be passed to EVM contracts for verification
+     */
+    payload: Uint8Array;
+}
+/**
+ * Input parameters for listing attestations
+ */
+export interface ListAttestationsInput {
+    /**
+     * Optional: Filter by requester address (20 bytes)
+     * If provided, only returns attestations requested by this address
+     */
+    requester?: Uint8Array;
+    /**
+     * Optional: Maximum number of results (1-5000, default 5000)
+     */
+    limit?: number;
+    /**
+     * Optional: Pagination offset (default 0)
+     */
+    offset?: number;
+    /**
+     * Optional: Sort order
+     *
+     * Allowed values:
+     * - "created_height asc"
+     * - "created_height desc"
+     * - "signed_height asc"
+     * - "signed_height desc"
+     *
+     * Case-insensitive
+     */
+    orderBy?: string;
+}
+/**
+ * Metadata for a single attestation
+ */
+export interface AttestationMetadata {
+    /**
+     * Transaction ID for this attestation request
+     */
+    requestTxId: string;
+    /**
+     * Attestation hash (identifies this attestation)
+     */
+    attestationHash: Uint8Array;
+    /**
+     * Address of the requester (20 bytes)
+     */
+    requester: Uint8Array;
+    /**
+     * Block height when attestation was created
+     */
+    createdHeight: number;
+    /**
+     * Block height when attestation was signed (null if not yet signed)
+     */
+    signedHeight: number | null;
+    /**
+     * Whether signature is encrypted
+     */
+    encryptSig: boolean;
+}
+/**
+ * Validates attestation request input
+ *
+ * @param input - The attestation request to validate
+ * @throws Error if validation fails
+ */
+export declare function validateAttestationRequest(input: RequestAttestationInput): void;
+/**
+ * Validates orderBy parameter (case-insensitive)
+ *
+ * @param orderBy - The orderBy value to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidOrderBy(orderBy: string): boolean;
+/**
+ * Validates list attestations input
+ *
+ * @param input - The list attestations input to validate
+ * @throws Error if validation fails
+ */
+export declare function validateListAttestationsInput(input: ListAttestationsInput): void;
+//# sourceMappingURL=attestation.d.ts.map

package/dist/types/types/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/types/attestation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,GAAG,EAAE,CAAC;IAEZ;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,eAAe,EAAE,UAAU,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAqC/E;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CA8BhF"}

package/dist/types/util/AttestationEncoding.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Argument encoding for attestation requests
+ *
+ * This module encodes action arguments into the canonical format expected by
+ * the node's request_attestation action. It uses kwil-js's native encoding
+ * to ensure perfect compatibility with kwil-db's EncodedValue.MarshalBinary() format.
+ */
+/**
+ * Encodes action arguments into canonical bytes using kwil-js utilities.
+ *
+ * Format: [arg_count:uint32(LE)][length:uint32(LE)][encoded_arg1][length:uint32(LE)][encoded_arg2]...
+ *
+ * Each encoded_arg uses kwil-db's EncodedValue.MarshalBinary() format.
+ *
+ * @param args - Array of arguments to encode
+ * @returns Encoded bytes
+ * @throws Error if any argument cannot be encoded
+ */
+export declare function encodeActionArgs(args: any[]): Uint8Array;
+/**
+ * Reads a uint32 value in little-endian format (for testing)
+ *
+ * @param buffer - Source buffer
+ * @param offset - Offset in buffer
+ * @returns The uint32 value
+ */
+export declare function readUint32LE(buffer: Uint8Array, offset: number): number;
+//# sourceMappingURL=AttestationEncoding.d.ts.map

package/dist/types/util/AttestationEncoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttestationEncoding.d.ts","sourceRoot":"","sources":["../../../src/util/AttestationEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,UAAU,CA2CxD;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trufnetwork/sdk-js",
-  "version": "0.4.10",
+  "version": "0.5.0",
   "description": "TRUF.NETWORK SDK for JavaScript/TypeScript",
   "type": "module",
   "keywords": [
@@ -51,7 +51,7 @@
     "test:integration": "vitest tests/integration/ --run"
   },
   "dependencies": {
-    "@trufnetwork/kwil-js": "0.9.8",
+    "@trufnetwork/kwil-js": "^0.9.9",
     "crypto-hash": "^3.1.0",
     "ethers": "^6.13.5",
     "lodash": "^4.17.21",