@amadeus-protocol/sdk 1.0.0

package/dist/encryption.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Password-Based Encryption Utilities
+ *
+ * Provides secure password-based encryption using PBKDF2 key derivation
+ * and AES-GCM encryption. Suitable for encrypting sensitive wallet data.
+ */
+/**
+ * Derive a cryptographic key from a password using PBKDF2
+ *
+ * @param password - Password string
+ * @param salt - Salt as Uint8Array or ArrayBuffer
+ * @param iterations - Number of PBKDF2 iterations (default: 100,000)
+ * @returns Derived AES-GCM key
+ */
+export declare function deriveKey(password: string, salt: Uint8Array | ArrayBuffer, iterations?: number): Promise<CryptoKey>;
+/**
+ * Generate a cryptographically secure random salt
+ *
+ * @returns Random salt (16 bytes)
+ */
+export declare function generateSalt(): Uint8Array;
+/**
+ * Generate a cryptographically secure random initialization vector
+ *
+ * @returns Random IV (12 bytes)
+ */
+export declare function generateIV(): Uint8Array;
+/**
+ * Encrypted data payload (Base64 encoded)
+ *
+ * Uses Base64 encoding for binary payloads like vaults (more efficient than Base58).
+ * Base58 is reserved for addresses, keys, and hashes.
+ */
+export interface EncryptedPayload {
+    /** Encrypted data (Base64 encoded) */
+    encryptedData: string;
+    /** Initialization vector (Base64 encoded) */
+    iv: string;
+    /** Salt used for key derivation (Base64 encoded) */
+    salt: string;
+}
+/**
+ * Encrypt plaintext with a password using AES-GCM
+ *
+ * Uses PBKDF2 for key derivation and Base64 encoding for output.
+ * Suitable for encrypting sensitive wallet data like private keys.
+ *
+ * **Encoding Standard**: Uses Base64 encoding for binary payloads (RFC 4648).
+ * Base58 is used for addresses, keys, and hashes elsewhere in the SDK.
+ *
+ * @param plaintext - Plaintext string to encrypt
+ * @param password - Password for encryption
+ * @returns Encrypted payload with encryptedData, IV, and salt (all Base64 encoded)
+ *
+ * @example
+ * ```ts
+ * const encrypted = await encryptWithPassword('sensitive data', 'my-password')
+ * // Store encrypted.encryptedData, encrypted.iv, encrypted.salt
+ * ```
+ */
+export declare function encryptWithPassword(plaintext: string, password: string): Promise<EncryptedPayload>;
+/**
+ * Decrypt encrypted data with a password
+ *
+ * @param payload - Encrypted payload (Base64 encoded)
+ * @param password - Password used for encryption
+ * @returns Decrypted plaintext string
+ * @throws {Error} If decryption fails (wrong password or corrupted data)
+ *
+ * @example
+ * ```ts
+ * const decrypted = await decryptWithPassword(encrypted, 'my-password')
+ * ```
+ */
+export declare function decryptWithPassword(payload: EncryptedPayload, password: string): Promise<string>;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqCH;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GAAG,WAAW,EAC9B,UAAU,GAAE,MAA0B,GACpC,OAAO,CAAC,SAAS,CAAC,CAgBpB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAIzC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAIvC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/encryption.js

@@ -0,0 +1,137 @@
+/**
+ * Password-Based Encryption Utilities
+ *
+ * Provides secure password-based encryption using PBKDF2 key derivation
+ * and AES-GCM encryption. Suitable for encrypting sensitive wallet data.
+ */
+import { uint8ArrayToBase64, base64ToUint8Array } from './encoding';
+import { uint8ArrayToArrayBuffer } from './encoding';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * PBKDF2 iterations for key derivation (100,000 iterations for security)
+ * Matches web wallet implementation for consistency
+ */
+const PBKDF2_ITERATIONS = 100_000;
+/**
+ * Salt length in bytes (128 bits)
+ */
+const SALT_LENGTH = 16;
+/**
+ * IV length in bytes for AES-GCM (96 bits)
+ */
+const IV_LENGTH = 12;
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Import password as a PBKDF2 key
+ */
+async function importPbkdf2Key(password) {
+    const enc = new TextEncoder();
+    return crypto.subtle.importKey('raw', enc.encode(password), 'PBKDF2', false, ['deriveKey']);
+}
+/**
+ * Derive a cryptographic key from a password using PBKDF2
+ *
+ * @param password - Password string
+ * @param salt - Salt as Uint8Array or ArrayBuffer
+ * @param iterations - Number of PBKDF2 iterations (default: 100,000)
+ * @returns Derived AES-GCM key
+ */
+export async function deriveKey(password, salt, iterations = PBKDF2_ITERATIONS) {
+    const baseKey = await importPbkdf2Key(password);
+    const saltBuffer = salt instanceof Uint8Array ? uint8ArrayToArrayBuffer(salt) : salt;
+    return crypto.subtle.deriveKey({
+        name: 'PBKDF2',
+        salt: saltBuffer,
+        iterations,
+        hash: 'SHA-256'
+    }, baseKey, { name: 'AES-GCM', length: 256 }, false, ['encrypt', 'decrypt']);
+}
+// ============================================================================
+// Random Generation
+// ============================================================================
+/**
+ * Generate a cryptographically secure random salt
+ *
+ * @returns Random salt (16 bytes)
+ */
+export function generateSalt() {
+    const salt = new Uint8Array(SALT_LENGTH);
+    crypto.getRandomValues(salt);
+    return salt;
+}
+/**
+ * Generate a cryptographically secure random initialization vector
+ *
+ * @returns Random IV (12 bytes)
+ */
+export function generateIV() {
+    const iv = new Uint8Array(IV_LENGTH);
+    crypto.getRandomValues(iv);
+    return iv;
+}
+/**
+ * Encrypt plaintext with a password using AES-GCM
+ *
+ * Uses PBKDF2 for key derivation and Base64 encoding for output.
+ * Suitable for encrypting sensitive wallet data like private keys.
+ *
+ * **Encoding Standard**: Uses Base64 encoding for binary payloads (RFC 4648).
+ * Base58 is used for addresses, keys, and hashes elsewhere in the SDK.
+ *
+ * @param plaintext - Plaintext string to encrypt
+ * @param password - Password for encryption
+ * @returns Encrypted payload with encryptedData, IV, and salt (all Base64 encoded)
+ *
+ * @example
+ * ```ts
+ * const encrypted = await encryptWithPassword('sensitive data', 'my-password')
+ * // Store encrypted.encryptedData, encrypted.iv, encrypted.salt
+ * ```
+ */
+export async function encryptWithPassword(plaintext, password) {
+    const enc = new TextEncoder();
+    const iv = generateIV();
+    const salt = generateSalt();
+    const key = await deriveKey(password, salt);
+    const ivBuffer = uint8ArrayToArrayBuffer(iv);
+    const encryptedBuf = await crypto.subtle.encrypt({ name: 'AES-GCM', iv: ivBuffer }, key, enc.encode(plaintext));
+    return {
+        encryptedData: uint8ArrayToBase64(new Uint8Array(encryptedBuf)),
+        iv: uint8ArrayToBase64(iv),
+        salt: uint8ArrayToBase64(salt)
+    };
+}
+/**
+ * Decrypt encrypted data with a password
+ *
+ * @param payload - Encrypted payload (Base64 encoded)
+ * @param password - Password used for encryption
+ * @returns Decrypted plaintext string
+ * @throws {Error} If decryption fails (wrong password or corrupted data)
+ *
+ * @example
+ * ```ts
+ * const decrypted = await decryptWithPassword(encrypted, 'my-password')
+ * ```
+ */
+export async function decryptWithPassword(payload, password) {
+    const dec = new TextDecoder();
+    const ivBytes = base64ToUint8Array(payload.iv);
+    const saltBytes = base64ToUint8Array(payload.salt);
+    const encryptedBytes = base64ToUint8Array(payload.encryptedData);
+    const key = await deriveKey(password, saltBytes);
+    const iv = uint8ArrayToArrayBuffer(ivBytes);
+    const encrypted = uint8ArrayToArrayBuffer(encryptedBytes);
+    try {
+        const plaintextBuf = await crypto.subtle.decrypt({ name: 'AES-GCM', iv }, key, encrypted);
+        return dec.decode(plaintextBuf);
+    }
+    catch {
+        throw new Error('Decryption failed. Incorrect password or corrupted data.');
+    }
+}
+//# sourceMappingURL=encryption.js.map

package/dist/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @amadeus-protocol/sdk
+ *
+ * Official TypeScript/JavaScript SDK for Amadeus Protocol
+ *
+ * This SDK provides:
+ * - Canonical serialization (VecPack)
+ * - Cryptographic operations (BLS12-381, Base58)
+ * - Transaction building and signing
+ * - Token amount conversions
+ * - Full-featured API client for Amadeus nodes
+ *
+ * @example
+ * ```ts
+ * import { AmadeusSDK, TransactionBuilder, generateKeypair } from '@amadeus-protocol/sdk'
+ *
+ * // Initialize SDK
+ * const sdk = new AmadeusSDK()
+ *
+ * // Generate keypair
+ * const keypair = generateKeypair()
+ *
+ * // Build and submit transaction
+ * const builder = new TransactionBuilder(keypair.privateKey)
+ * const { txHash, txPacked } = builder.transfer({
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ *
+ * const result = await sdk.transaction.submit(txPacked)
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from './types';
+export * from './constants';
+export * from './serialization';
+export * from './crypto';
+export * from './conversion';
+export * from './encoding';
+export * from './encryption';
+export * from './transaction-builder';
+export * from './client';
+export * from './api';
+export * from './sdk';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * @amadeus-protocol/sdk
+ *
+ * Official TypeScript/JavaScript SDK for Amadeus Protocol
+ *
+ * This SDK provides:
+ * - Canonical serialization (VecPack)
+ * - Cryptographic operations (BLS12-381, Base58)
+ * - Transaction building and signing
+ * - Token amount conversions
+ * - Full-featured API client for Amadeus nodes
+ *
+ * @example
+ * ```ts
+ * import { AmadeusSDK, TransactionBuilder, generateKeypair } from '@amadeus-protocol/sdk'
+ *
+ * // Initialize SDK
+ * const sdk = new AmadeusSDK()
+ *
+ * // Generate keypair
+ * const keypair = generateKeypair()
+ *
+ * // Build and submit transaction
+ * const builder = new TransactionBuilder(keypair.privateKey)
+ * const { txHash, txPacked } = builder.transfer({
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ *
+ * const result = await sdk.transaction.submit(txPacked)
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from './types';
+export * from './constants';
+export * from './serialization';
+export * from './crypto';
+export * from './conversion';
+export * from './encoding';
+export * from './encryption';
+export * from './transaction-builder';
+export * from './client';
+export * from './api';
+export * from './sdk';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA"}

package/dist/schemas.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Effect Schema definitions for validation
+ *
+ * Provides reusable schemas for validating common data types used throughout the SDK
+ */
+import { Schema } from 'effect';
+/**
+ * Schema for Base58 encoded hash (used for transaction IDs, entry hashes, etc.)
+ */
+export declare const Base58HashSchema: Schema.filter<Schema.filter<typeof Schema.String>>;
+/**
+ * Schema for Base58 encoded address
+ */
+export declare const Base58AddressSchema: Schema.filter<Schema.filter<typeof Schema.String>>;
+/**
+ * Schema for Base58 encoded public key
+ */
+export declare const Base58PublicKeySchema: Schema.filter<Schema.filter<typeof Schema.String>>;
+/**
+ * Schema for transaction sort order
+ */
+export declare const TransactionSortSchema: Schema.Literal<["asc", "desc"]>;
+/**
+ * Schema for transaction filters
+ * Validates optional fields when they are present
+ */
+export declare const TransactionFiltersSchema: Schema.Struct<{
+    limit: Schema.optional<Schema.refine<number, typeof Schema.NonNegative>>;
+    offset: Schema.optional<Schema.refine<number, typeof Schema.NonNegative>>;
+    sort: Schema.optional<Schema.Literal<["asc", "desc"]>>;
+    cursor: Schema.optional<typeof Schema.String>;
+    cursor_b58: Schema.optional<typeof Schema.String>;
+    contract: Schema.optional<typeof Schema.String>;
+    contract_b58: Schema.optional<typeof Schema.String>;
+    function: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<Schema.Literal<["sent", "recv"]>>;
+}>;
+/**
+ * Schema for non-empty string
+ */
+export declare const NonEmptyStringSchema: Schema.filter<typeof Schema.String>;
+/**
+ * Schema for non-empty Uint8Array
+ */
+export declare const NonEmptyUint8ArraySchema: Schema.filter<Schema.instanceOf<Uint8Array<ArrayBuffer>>>;
+/**
+ * Schema for ArrayBuffer (can be converted to Uint8Array)
+ */
+export declare const NonEmptyArrayBufferSchema: Schema.filter<Schema.instanceOf<ArrayBuffer>>;
+/**
+ * Schema for transaction data (Uint8Array or non-empty Base58 string)
+ */
+export declare const TransactionDataSchema: Schema.Union<[Schema.filter<Schema.instanceOf<Uint8Array<ArrayBuffer>>>, Schema.filter<Schema.filter<typeof Schema.String>>]>;
+/**
+ * Schema for contract key (Uint8Array or Base58 string)
+ */
+export declare const ContractKeySchema: Schema.Union<[Schema.filter<Schema.instanceOf<Uint8Array<ArrayBuffer>>>, Schema.filter<Schema.filter<typeof Schema.String>>]>;
+/**
+ * Schema for bytecode (Uint8Array or ArrayBuffer)
+ */
+export declare const BytecodeSchema: Schema.Union<[Schema.filter<Schema.instanceOf<Uint8Array<ArrayBuffer>>>, Schema.filter<Schema.instanceOf<ArrayBuffer>>]>;
+/**
+ * Schema for safe positive integer (>= 1, within safe integer range)
+ * Uses built-in Schema.Int and Schema.positive() with MAX_SAFE_INTEGER constraint
+ */
+export declare const SafePositiveNumberSchema: Schema.filter<Schema.filter<typeof Schema.Int>>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAQ/B;;GAEG;AACH,eAAO,MAAM,gBAAgB,oDAM5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,oDAM/B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,oDAMjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,iCAEhC,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;EAYnC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,qCAA8C,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,wBAAwB,2DAKpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,+CAKrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,+HAMhC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,+HAM5B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,0HAMzB,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,iDAMpC,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,103 @@
+/**
+ * Effect Schema definitions for validation
+ *
+ * Provides reusable schemas for validating common data types used throughout the SDK
+ */
+import { Schema } from 'effect';
+/**
+ * Base58 character set regex pattern
+ * Base58 excludes 0, O, I, l to avoid visual confusion
+ */
+const BASE58_PATTERN = /^[1-9A-HJ-NP-Za-km-z]+$/;
+/**
+ * Schema for Base58 encoded hash (used for transaction IDs, entry hashes, etc.)
+ */
+export const Base58HashSchema = Schema.String.pipe(Schema.nonEmptyString(), Schema.pattern(BASE58_PATTERN, {
+    identifier: 'Base58Hash',
+    description: 'Base58 encoded hash string'
+}));
+/**
+ * Schema for Base58 encoded address
+ */
+export const Base58AddressSchema = Schema.String.pipe(Schema.nonEmptyString(), Schema.pattern(BASE58_PATTERN, {
+    identifier: 'Base58Address',
+    description: 'Base58 encoded address string'
+}));
+/**
+ * Schema for Base58 encoded public key
+ */
+export const Base58PublicKeySchema = Schema.String.pipe(Schema.nonEmptyString(), Schema.pattern(BASE58_PATTERN, {
+    identifier: 'Base58PublicKey',
+    description: 'Base58 encoded public key string'
+}));
+/**
+ * Schema for transaction sort order
+ */
+export const TransactionSortSchema = Schema.Literal('asc', 'desc').annotations({
+    identifier: 'TransactionSort'
+});
+/**
+ * Schema for transaction filters
+ * Validates optional fields when they are present
+ */
+export const TransactionFiltersSchema = Schema.Struct({
+    limit: Schema.optional(Schema.NonNegativeInt),
+    offset: Schema.optional(Schema.NonNegativeInt),
+    sort: Schema.optional(TransactionSortSchema),
+    cursor: Schema.optional(Schema.String),
+    cursor_b58: Schema.optional(Schema.String),
+    contract: Schema.optional(Schema.String),
+    contract_b58: Schema.optional(Schema.String),
+    function: Schema.optional(Schema.String),
+    type: Schema.optional(Schema.Literal('sent', 'recv'))
+}).annotations({
+    identifier: 'TransactionFilters'
+});
+/**
+ * Schema for non-empty string
+ */
+export const NonEmptyStringSchema = Schema.String.pipe(Schema.nonEmptyString());
+/**
+ * Schema for non-empty Uint8Array
+ */
+export const NonEmptyUint8ArraySchema = Schema.instanceOf(Uint8Array).pipe(Schema.filter((arr) => arr.length > 0, {
+    identifier: 'NonEmptyUint8Array',
+    description: 'Non-empty Uint8Array'
+}));
+/**
+ * Schema for ArrayBuffer (can be converted to Uint8Array)
+ */
+export const NonEmptyArrayBufferSchema = Schema.instanceOf(ArrayBuffer).pipe(Schema.filter((buf) => buf.byteLength > 0, {
+    identifier: 'NonEmptyArrayBuffer',
+    description: 'Non-empty ArrayBuffer'
+}));
+/**
+ * Schema for transaction data (Uint8Array or non-empty Base58 string)
+ */
+export const TransactionDataSchema = Schema.Union(NonEmptyUint8ArraySchema, Base58HashSchema).annotations({
+    identifier: 'TransactionData',
+    description: 'Transaction data as Uint8Array or Base58 encoded string'
+});
+/**
+ * Schema for contract key (Uint8Array or Base58 string)
+ */
+export const ContractKeySchema = Schema.Union(NonEmptyUint8ArraySchema, Base58HashSchema).annotations({
+    identifier: 'ContractKey',
+    description: 'Contract key as Uint8Array or Base58 encoded string'
+});
+/**
+ * Schema for bytecode (Uint8Array or ArrayBuffer)
+ */
+export const BytecodeSchema = Schema.Union(NonEmptyUint8ArraySchema, NonEmptyArrayBufferSchema).annotations({
+    identifier: 'Bytecode',
+    description: 'Contract bytecode as Uint8Array or ArrayBuffer'
+});
+/**
+ * Schema for safe positive integer (>= 1, within safe integer range)
+ * Uses built-in Schema.Int and Schema.positive() with MAX_SAFE_INTEGER constraint
+ */
+export const SafePositiveNumberSchema = Schema.Int.pipe(Schema.positive(), Schema.filter((n) => n <= Number.MAX_SAFE_INTEGER, {
+    identifier: 'SafePositiveNumber',
+    description: 'Positive integer within safe integer range'
+}));
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/sdk.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Amadeus SDK
+ *
+ * Main SDK class that provides access to all API modules and utilities.
+ * This is the primary entry point for interacting with the Amadeus Protocol.
+ */
+import { AmadeusClient } from './client';
+import type { AmadeusSDKConfig } from './types';
+import { ChainAPI, PeerAPI, TransactionAPI, WalletAPI, ContractAPI, EpochAPI, ProofAPI } from './api';
+/**
+ * Main Amadeus SDK class
+ *
+ * Provides a unified interface to interact with the Amadeus Protocol.
+ * All API modules are accessible through this class instance.
+ *
+ * @example
+ * ```ts
+ * import { AmadeusSDK } from '@amadeus-protocol/sdk'
+ *
+ * // Initialize SDK with default node URL
+ * const sdk = new AmadeusSDK({
+ *   baseUrl: 'https://nodes.amadeus.bot/api'
+ * })
+ *
+ * // Query chain
+ * const tip = await sdk.chain.getTip()
+ * const stats = await sdk.chain.getStats()
+ *
+ * // Query wallet balances
+ * const balance = await sdk.wallet.getBalance('5Kd3N...', 'AMA')
+ * const allBalances = await sdk.wallet.getAllBalances('5Kd3N...')
+ *
+ * // Submit transaction
+ * const result = await sdk.transaction.submit(txPacked)
+ *
+ * // Query contracts
+ * const contractData = await sdk.contract.get(key)
+ *
+ * // Query epoch data
+ * const scores = await sdk.epoch.getScore()
+ * ```
+ */
+export declare class AmadeusSDK {
+    /** HTTP client instance */
+    readonly client: AmadeusClient;
+    /** Chain API module for blockchain queries */
+    readonly chain: ChainAPI;
+    /** Peer API module for network information */
+    readonly peer: PeerAPI;
+    /** Transaction API module for submitting transactions */
+    readonly transaction: TransactionAPI;
+    /** Wallet API module for balance queries */
+    readonly wallet: WalletAPI;
+    /** Contract API module for smart contract interactions */
+    readonly contract: ContractAPI;
+    /** Epoch API module for epoch and validator data */
+    readonly epoch: EpochAPI;
+    /** Proof API module for validator proofs */
+    readonly proof: ProofAPI;
+    /**
+     * Create a new AmadeusSDK instance
+     *
+     * @param config - SDK configuration
+     * @throws {AmadeusSDKError} If configuration is invalid
+     *
+     * @example
+     * ```ts
+     * // Use default node URL
+     * const sdk = new AmadeusSDK({})
+     *
+     * // Use custom node URL
+     * const sdk = new AmadeusSDK({
+     *   baseUrl: 'https://custom-node.com/api',
+     *   timeout: 60000
+     * })
+     * ```
+     */
+    constructor(config?: AmadeusSDKConfig);
+    /**
+     * Get SDK version
+     */
+    static getVersion(): string;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): AmadeusSDKConfig;
+    /**
+     * Update the base URL
+     */
+    setBaseUrl(url: string): void;
+    /**
+     * Update headers
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /**
+     * Cancel ongoing requests
+     */
+    cancel(): void;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EACN,QAAQ,EACR,OAAO,EACP,cAAc,EACd,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,OAAO,CAAA;AAGd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAU;IACtB,2BAA2B;IAC3B,SAAgB,MAAM,EAAE,aAAa,CAAA;IAErC,8CAA8C;IAC9C,SAAgB,KAAK,EAAE,QAAQ,CAAA;IAE/B,8CAA8C;IAC9C,SAAgB,IAAI,EAAE,OAAO,CAAA;IAE7B,yDAAyD;IACzD,SAAgB,WAAW,EAAE,cAAc,CAAA;IAE3C,4CAA4C;IAC5C,SAAgB,MAAM,EAAE,SAAS,CAAA;IAEjC,0DAA0D;IAC1D,SAAgB,QAAQ,EAAE,WAAW,CAAA;IAErC,oDAAoD;IACpD,SAAgB,KAAK,EAAE,QAAQ,CAAA;IAE/B,4CAA4C;IAC5C,SAAgB,KAAK,EAAE,QAAQ,CAAA;IAE/B;;;;;;;;;;;;;;;;;OAiBG;gBACS,MAAM,GAAE,gBAA4C;IAahE;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B;;OAEG;IACH,SAAS,IAAI,gBAAgB;IAI7B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIjD;;OAEG;IACH,MAAM,IAAI,IAAI;CAGd"}