@amadeus-protocol/sdk 1.1.0 → 1.1.2

package/README.md

@@ -20,6 +20,19 @@ pnpm add @amadeus-protocol/sdk
 bun add @amadeus-protocol/sdk
 ```
 
+> **ESM-only**: this package is published as pure ESM (`"type": "module"`). Use Node.js 20+ with `"type": "module"` in your `package.json`, or any modern bundler (Vite, webpack, esbuild, Metro). For CommonJS consumers, run via [`tsx`](https://github.com/privatenumber/tsx). See [Troubleshooting](https://docs.ama.one/sdk/9.-troubleshooting.md) for the `1.0.x` `ERR_MODULE_NOT_FOUND` issue and upgrade path.
+
+## What's New in 1.1.0
+
+- **`contract.view()`** — read-only contract execution
+- **`chain.getByFilter()`** / **`chain.getKpi()`** — filtered tx queries + protocol KPIs
+- **`proof.getContractStateProof()`** — merkle proofs for contract state
+- **`submitAndWait(txPacked, { finalized: true })`** — wait for finality instead of confirmation
+- **NFT contract** — `NFT_ABI`, `buildNftTransfer/Mint/CreateCollection`, `TransactionBuilder.nftTransfer/nftMint/nftCreateCollection`
+- **ESM fix** — published `dist/*.js` now resolves correctly under raw `node` (the `1.0.x` `ERR_MODULE_NOT_FOUND` bug)
+
+See the [CHANGELOG](./CHANGELOG.md) for full release history.
+
 ## Features
 
 - **Canonical Serialization (VecPack)**: Deterministic encoding/decoding for cryptographic operations
@@ -46,7 +59,7 @@ const sdk = new AmadeusSDK({
 
 // Query chain
 const tip = await sdk.chain.getTip()
-console.log('Current height:', tip.entry.height)
+console.log('Current height:', tip.entry.header.height)
 
 // Query wallet balance
 const balance = await sdk.wallet.getBalance('5Kd3N...', 'AMA')
@@ -72,6 +85,8 @@ const sdk = new AmadeusSDK({
 const stats = await sdk.chain.getStats()
 const tip = await sdk.chain.getTip()
 const entry = await sdk.chain.getByHash('5Kd3N...')
+const { txs, cursor } = await sdk.chain.getByFilter({ contract: 'Coin', function: 'transfer' })
+const { kpi } = await sdk.chain.getKpi()
 
 // Wallet API
 const balance = await sdk.wallet.getBalance('5Kd3N...', 'AMA')
@@ -79,12 +94,18 @@ const allBalances = await sdk.wallet.getAllBalances('5Kd3N...')
 
 // Transaction API
 const result = await sdk.transaction.submit(txPacked)
-const resultWithWait = await sdk.transaction.submitAndWait(txPacked)
+const confirmed = await sdk.transaction.submitAndWait(txPacked)
+const finalized = await sdk.transaction.submitAndWait(txPacked, { finalized: true })
 const tx = await sdk.transaction.get('5Kd3N...')
 
 // Contract API
 const contractData = await sdk.contract.get(key)
 const richlist = await sdk.contract.getRichlist()
+const { success, result } = await sdk.contract.view({
+	contract: 'LockupPrime',
+	function: 'view_balance',
+	args: ['my_vault']
+})
 
 // Epoch API
 const scores = await sdk.epoch.getScore()
@@ -93,6 +114,10 @@ const emission = await sdk.epoch.getEmissionAddress('5Kd3N...')
 // Peer API
 const nodes = await sdk.peer.getNodes()
 const trainers = await sdk.peer.getTrainers()
+
+// Proof API
+const validatorProof = await sdk.proof.getValidators(entryHash)
+const stateProof = await sdk.proof.getContractStateProof(stateKey)
 ```
 
 ### Key Generation
@@ -151,6 +176,137 @@ const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', [
 ])
 ```
 
+#### ABI-Driven (Lockup, LockupPrime, etc.)
+
+The recommended pattern for built-in contracts. Pass any ABI to `builder.contract(abi)` and get fully-typed function calls:
+
+```typescript
+import {
+	TransactionBuilder,
+	LOCKUP_PRIME_ABI,
+	LOCKUP_ABI,
+	toAtomicAma
+} from '@amadeus-protocol/sdk'
+
+const builder = new TransactionBuilder('5Kd3N...')
+
+// LockupPrime — auto-typed methods derived from the ABI
+builder.contract(LOCKUP_PRIME_ABI).lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+builder.contract(LOCKUP_PRIME_ABI).unlock({ vaultIndex: '3' })
+builder.contract(LOCKUP_PRIME_ABI).daily_checkin({ vaultIndex: '7' })
+
+// Lockup
+builder.contract(LOCKUP_ABI).unlock({ vaultIndex: '5' })
+```
+
+#### NFT (transfer, mint, create_collection)
+
+The `Nft` built-in contract has dedicated builder methods. NFT amounts are integer counts, **not** AMA atomic units.
+
+```typescript
+const builder = new TransactionBuilder(privateKey)
+
+// Create a collection (caller becomes owner)
+builder.nftCreateCollection({ collection: 'AGENTIC', soulbound: false })
+
+// Mint tokens (collection owner only)
+builder.nftMint({ recipient: '5Kd3N...', amount: 10, collection: 'AGENTIC', token: '1' })
+
+// Transfer
+builder.nftTransfer({ recipient: '5Kd3N...', amount: 1, collection: 'AGENTIC', token: '1' })
+```
+
+Static variants: `TransactionBuilder.buildSignedNftTransfer/Mint/CreateCollection(input)` — each takes the same params plus `senderPrivkey`.
+
+### Signing Transactions
+
+The SDK supports two patterns. Pick whichever fits your workflow.
+
+#### Pattern 1 — Auto-signed (high-level, recommended)
+
+The `TransactionBuilder` instance methods build **and** sign in one call. Best for app code where you have the private key in hand.
+
+```typescript
+import { TransactionBuilder, LOCKUP_PRIME_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
+
+const builder = new TransactionBuilder('5Kd3N...') // Base58 seed
+
+// Coin transfer
+const a = builder.transfer({ recipient: '5Kd3N...', amount: 10.5, symbol: 'AMA' })
+
+// ABI-driven (any contract)
+const b = builder.contract(LOCKUP_PRIME_ABI).lock({
+	amount: toAtomicAma(100).toString(),
+	tier: '30d'
+})
+
+// NFT
+const c = builder.nftTransfer({
+	recipient: '5Kd3N...',
+	amount: 1,
+	collection: 'AGENTIC',
+	token: '1'
+})
+
+// All return { txHash, txPacked } ready for sdk.transaction.submit(txPacked)
+```
+
+#### Pattern 2 — Manual: build a `ContractCall`, sign separately
+
+Build a `ContractCall` with a standalone helper or `createContract(ABI)`, then sign it independently with `TransactionBuilder.signCall(privkey, call)`. Useful when:
+
+- You want to inspect or log the call before signing
+- The signing key lives somewhere else (HSM, separate process, separate machine)
+- You want to batch-build and sign at the end
+
+```typescript
+import {
+	TransactionBuilder,
+	createContract,
+	LOCKUP_PRIME_ABI,
+	buildCoinTransfer,
+	buildNftTransfer,
+	toAtomicAma
+} from '@amadeus-protocol/sdk'
+
+// Build a ContractCall — three ways:
+
+// A. Standalone helper (Coin)
+const callA = buildCoinTransfer({ recipient: '5Kd3N...', amount: 10.5, symbol: 'AMA' })
+
+// B. Standalone helper (NFT)
+const callB = buildNftTransfer({
+	recipient: '5Kd3N...',
+	amount: 1,
+	collection: 'AGENTIC',
+	token: '1'
+})
+
+// C. ABI-driven, any contract
+const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+const callC = lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+
+// Inspect if you want
+console.log('Will call:', callC.contract, callC.method, callC.args)
+
+// Sign with any private key (no builder instance needed)
+const { txHash, txPacked } = TransactionBuilder.signCall('5Kd3N...', callC)
+```
+
+#### Build-unsigned-then-sign (debugging)
+
+If you need to inspect the full unsigned transaction (nonce, signer, action) before signing:
+
+```typescript
+const builder = new TransactionBuilder('5Kd3N...')
+
+const unsigned = builder.buildTransfer({ recipient: '5Kd3N...', amount: 10.5, symbol: 'AMA' })
+console.log('Nonce:', unsigned.tx.nonce)
+console.log('Action:', unsigned.tx.action)
+
+const { txHash, txPacked } = builder.sign(unsigned)
+```
+
 #### Using Static Methods
 
 ```typescript
@@ -229,22 +385,19 @@ const atomic = toAtomicAma(1.5) // Returns 1500000000
 const ama = fromAtomicAma(1500000000) // Returns 1.5
 ```
 
-### Signing Transactions
+### Mnemonics (BIP39)
 
 ```typescript
-import { TransactionBuilder } from '@amadeus-protocol/sdk'
+import { generateMnemonic, validateMnemonic, mnemonicToSeedBase58 } from '@amadeus-protocol/sdk'
 
-// Using TransactionBuilder instance
-const builder = new TransactionBuilder('5Kd3N...')
-
-// Build unsigned transaction
-const unsignedTx = builder.build('Coin', 'transfer', args)
+// Generate a 12-word mnemonic
+const mnemonic = generateMnemonic()
 
-// Sign the transaction
-const { txHash, txPacked } = builder.sign(unsignedTx)
-
-// Or build and sign in one step
-const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', args)
+// Validate a mnemonic
+if (validateMnemonic(mnemonic)) {
+	// Derive a Base58 seed (compatible with TransactionBuilder)
+	const seedBase58 = mnemonicToSeedBase58(mnemonic)
+}
 ```
 
 ### Encoding Utilities
@@ -300,6 +453,13 @@ const decrypted = await decryptWithPassword(encrypted, 'my-password')
 - `derivePublicKeyFromSeedBase58(base58Seed: string): string` - Derive public key from Base58 seed
 - `deriveSkAndSeed64FromBase58Seed(base58Seed64: string)` - Derive secret key and seed
 
+### Mnemonics (BIP39)
+
+- `generateMnemonic(): string` - Generate a 12-word BIP39 mnemonic
+- `validateMnemonic(mnemonic: string): boolean` - Validate a BIP39 mnemonic
+- `mnemonicToSeedBase58(mnemonic: string): string` - Derive a Base58 seed from a mnemonic
+- `encodeVaultSecret`, `decodeVaultSecret`, `detectInputType` - Vault helpers
+
 ### Encoding
 
 - `toBase58(buf: Uint8Array): string` - Encode bytes to Base58
@@ -311,11 +471,6 @@ const decrypted = await decryptWithPassword(encrypted, 'my-password')
 - `uint8ArrayToArrayBuffer(bytes: Uint8Array): ArrayBuffer` - Convert Uint8Array to ArrayBuffer
 - `arrayBufferToUint8Array(buffer: ArrayBuffer): Uint8Array` - Convert ArrayBuffer to Uint8Array
 
-### Signing
-
-- `signTx(hash: Uint8Array, sk: PrivKey): Uint8Array` - Sign a transaction hash
-- `signOOB(sk: string, msg: Uint8Array): Uint8Array` - Sign an out-of-band message
-
 ### Conversion
 
 - `toAtomicAma(ama: number): number` - Convert AMA to atomic units
@@ -333,18 +488,48 @@ const decrypted = await decryptWithPassword(encrypted, 'my-password')
 
 - `TransactionBuilder` - Class for building and signing transactions
     - **Constructor:** `new TransactionBuilder(privateKey?: string)` - Create a new builder instance
-    - **Instance Methods:**
-        - `build(contract, method, args, signerPk?): UnsignedTransactionWithHash` - Build an unsigned transaction
-        - `sign(unsignedTx, signerSk?): BuildTxResult` - Sign an unsigned transaction
-        - `buildAndSign(contract, method, args, signerPk?, signerSk?): BuildTxResult` - Build and sign in one step
-        - `buildTransfer(input, signerPk?): UnsignedTransactionWithHash` - Build an unsigned transfer
-        - `transfer(input): BuildTxResult` - Build and sign a transfer (convenience)
-    - **Static Methods:**
-        - `build(signerPk, contract, method, args): UnsignedTransactionWithHash` - Build unsigned transaction
-        - `sign(unsignedTx, signerSk): BuildTxResult` - Sign an unsigned transaction
-        - `buildAndSign(signerPk, signerSk, contract, method, args): BuildTxResult` - Build and sign in one step
-        - `buildTransfer(input, signerPk): UnsignedTransactionWithHash` - Build unsigned transfer
-        - `buildSignedTransfer(input): BuildTxResult` - Build and sign transfer (convenience)
+    - **ABI-driven (recommended):**
+        - `contract(abi)` - Returns a typed, signer-bound contract interface; each ABI function becomes a method that builds and signs in one step
+    - **Generic instance methods:**
+        - `build(contract, method, args, signerPk?): UnsignedTransactionWithHash`
+        - `sign(unsignedTx, signerSk?): BuildTransactionResult`
+        - `buildAndSign(contract, method, args, signerPk?, signerSk?): BuildTransactionResult`
+        - `buildFromCall(call): UnsignedTransactionWithHash`
+        - `buildAndSignCall(call): BuildTransactionResult`
+    - **Coin transfer:**
+        - `buildTransfer(input, signerPk?): UnsignedTransactionWithHash`
+        - `transfer(input): BuildTransactionResult`
+    - **NFT (Nft contract):**
+        - `nftTransfer({ recipient, amount, collection, token }): BuildTransactionResult`
+        - `nftMint({ recipient, amount, collection, token }): BuildTransactionResult`
+        - `nftCreateCollection({ collection, soulbound? }): BuildTransactionResult`
+    - **Lockup / LockupPrime convenience methods:**
+        - `lockupUnlock({ vaultIndex }): BuildTransactionResult`
+        - `lockupPrimeLock({ amount, tier }): BuildTransactionResult`
+        - `lockupPrimeUnlock({ vaultIndex }): BuildTransactionResult`
+        - `lockupPrimeDailyCheckin({ vaultIndex }): BuildTransactionResult`
+    - **Static methods:** `signCall`, `buildFromCall`, `buildAndSignCall`, `buildSignedTransfer`, `buildSignedNft{Transfer,Mint,CreateCollection}`, `buildSignedLockup{Unlock}`, `buildSignedLockupPrime{Lock,Unlock,DailyCheckin}`
+
+### Contract ABIs
+
+`as const` ABI definitions for built-in contracts. Pass any ABI to `createContract(abi)` or `builder.contract(abi)` for fully-typed function calls.
+
+- `LOCKUP_ABI` - `Lockup` (vesting) — `unlock(vaultIndex)`
+- `LOCKUP_PRIME_ABI` - `LockupPrime` — `lock(amount, tier)`, `unlock(vaultIndex)`, `daily_checkin(vaultIndex)`
+- `NFT_ABI` - `Nft` — `transfer`, `mint`, `create_collection`
+
+Standalone builders that return a `ContractCall`:
+
+- `buildCoinTransfer({ recipient, amount, symbol })`
+- `buildNftTransfer({ recipient, amount, collection, token })`
+- `buildNftMint({ recipient, amount, collection, token })`
+- `buildNftCreateCollection({ collection, soulbound? })`
+- `createContract(abi).fn(params)` - generic ABI-driven builder
+- `buildContractCall(abi, fn, params)` - lower-level ABI-driven builder
+
+### Full API Reference
+
+For complete documentation including request/response types, error handling, and end-to-end examples, see [docs.ama.one/sdk](https://docs.ama.one/sdk/1.-introduction.md).
 
 ## Examples
 

package/dist/api/chain.d.ts

@@ -13,7 +13,7 @@ declare class ChainAPI {
    * @example
    * ```ts
    * const { entry } = await sdk.chain.getTip()
-   * console.log('Current height:', entry.height)
+   * console.log('Current height:', entry.header.height)
    * ```
    */
   getTip(): Promise<GetTipResponse>;
@@ -25,7 +25,7 @@ declare class ChainAPI {
    * @example
    * ```ts
    * const { stats } = await sdk.chain.getStats()
-   * console.log('Total entries:', stats.total_entries)
+   * console.log('Tip height:', stats.height)
    * ```
    */
   getStats(): Promise<GetStatsResponse>;

package/dist/api/chain.js

@@ -15,7 +15,7 @@ var ChainAPI = class {
 	* @example
 	* ```ts
 	* const { entry } = await sdk.chain.getTip()
-	* console.log('Current height:', entry.height)
+	* console.log('Current height:', entry.header.height)
 	* ```
 	*/
 	async getTip() {
@@ -29,7 +29,7 @@ var ChainAPI = class {
 	* @example
 	* ```ts
 	* const { stats } = await sdk.chain.getStats()
-	* console.log('Total entries:', stats.total_entries)
+	* console.log('Tip height:', stats.height)
 	* ```
 	*/
 	async getStats() {

package/dist/api/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","names":[],"sources":["../../src/api/chain.ts"],"sourcesContent":["/**\n * Chain API\n *\n * Provides methods for querying blockchain data\n */\n\nimport type { AmadeusClient } from '../client'\nimport type {\n\tTransactionFilters,\n\tGetTipResponse,\n\tGetStatsResponse,\n\tGetByHashResponse,\n\tGetByHeightResponse,\n\tGetTransactionsInEntryResponse,\n\tGetTransactionEventsByAccountResponse,\n\tTransaction,\n\tTxByFilterParams,\n\tTxByFilterResponse,\n\tGetKpiResponse\n} from '../types'\nimport { Base58HashSchema, TransactionFiltersSchema } from '../schemas'\nimport { Schema } from 'effect'\nimport { validate } from '../validation'\n\nexport class ChainAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Get the current chain tip (latest entry)\n\t *\n\t * @returns Promise resolving to the latest chain entry\n\t *\n\t * @example\n\t * ```ts\n\t * const { entry } = await sdk.chain.getTip()\n\t * console.log('Current height:', entry.height)\n\t * ```\n\t */\n\tasync getTip(): Promise<GetTipResponse> {\n\t\treturn this.client.get<GetTipResponse>('/api/chain/tip')\n\t}\n\n\t/**\n\t * Get chain statistics\n\t *\n\t * @returns Promise resolving to chain statistics\n\t *\n\t * @example\n\t * ```ts\n\t * const { stats } = await sdk.chain.getStats()\n\t * console.log('Total entries:', stats.total_entries)\n\t * ```\n\t */\n\tasync getStats(): Promise<GetStatsResponse> {\n\t\treturn this.client.get<GetStatsResponse>('/api/chain/stats')\n\t}\n\n\t/**\n\t * Get entry by hash\n\t *\n\t * @param hash - Entry hash (Base58 encoded)\n\t * @param filterOnFunction - Optional function filter\n\t * @returns Promise resolving to chain entry\n\t * @throws {Error} If hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entry } = await sdk.chain.getByHash('5Kd3N...')\n\t * ```\n\t */\n\tasync getByHash(hash: string, filterOnFunction?: string): Promise<GetByHashResponse> {\n\t\tvalidate(Base58HashSchema, hash)\n\t\treturn this.client.get<GetByHashResponse>(`/api/chain/hash/${hash}`, {\n\t\t\tfilter_on_function: filterOnFunction\n\t\t})\n\t}\n\n\t/**\n\t * Get entries by height\n\t *\n\t * @param height - Block height (must be >= 0)\n\t * @returns Promise resolving to chain entries at the specified height\n\t * @throws {Error} If height is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entries } = await sdk.chain.getByHeight(1000)\n\t * ```\n\t */\n\tasync getByHeight(height: number): Promise<GetByHeightResponse> {\n\t\tvalidate(Schema.NonNegativeInt, height)\n\t\treturn this.client.get<GetByHeightResponse>(`/api/chain/height/${height}`)\n\t}\n\n\t/**\n\t * Get entries by height with transactions\n\t *\n\t * @param height - Block height (must be >= 0)\n\t * @returns Promise resolving to chain entries with transactions at the specified height\n\t * @throws {Error} If height is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entries } = await sdk.chain.getByHeightWithTxs(1000)\n\t * ```\n\t */\n\tasync getByHeightWithTxs(height: number): Promise<GetByHeightResponse> {\n\t\tvalidate(Schema.NonNegativeInt, height)\n\t\treturn this.client.get<GetByHeightResponse>(`/api/chain/height_with_txs/${height}`)\n\t}\n\n\t/**\n\t * Get a specific transaction by ID\n\t *\n\t * @param txid - Transaction ID (Base58 encoded)\n\t * @returns Promise resolving to transaction data\n\t * @throws {Error} If transaction ID is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = await sdk.chain.getTransaction('5Kd3N...')\n\t * ```\n\t */\n\tasync getTransaction(txid: string): Promise<Transaction> {\n\t\tvalidate(Base58HashSchema, txid)\n\t\treturn this.client.get<Transaction>(`/api/chain/tx/${txid}`)\n\t}\n\n\t/**\n\t * Get transactions in a specific entry\n\t *\n\t * @param entryHash - Entry hash (Base58 encoded)\n\t * @returns Promise resolving to transactions in the entry\n\t * @throws {Error} If entry hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs } = await sdk.chain.getTransactionsInEntry('5Kd3N...')\n\t * ```\n\t */\n\tasync getTransactionsInEntry(entryHash: string): Promise<GetTransactionsInEntryResponse> {\n\t\tvalidate(Base58HashSchema, entryHash)\n\t\treturn this.client.get<GetTransactionsInEntryResponse>(\n\t\t\t`/api/chain/txs_in_entry/${entryHash}`\n\t\t)\n\t}\n\n\t/**\n\t * Get transaction events by account with filtering\n\t *\n\t * @param account - Account address (Base58 encoded)\n\t * @param filters - Optional filters for transactions\n\t * @returns Promise resolving to transaction events\n\t * @throws {Error} If account address is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs, cursor } = await sdk.chain.getTransactionEventsByAccount('5Kd3N...', {\n\t *   limit: 10,\n\t *   sort: 'desc'\n\t * })\n\t * ```\n\t */\n\tasync getTransactionEventsByAccount(\n\t\taccount: string,\n\t\tfilters: TransactionFilters = {}\n\t): Promise<GetTransactionEventsByAccountResponse> {\n\t\tvalidate(Base58HashSchema, account)\n\t\tvalidate(TransactionFiltersSchema, filters)\n\n\t\treturn this.client.get<GetTransactionEventsByAccountResponse>(\n\t\t\t`/api/chain/tx_events_by_account/${account}`,\n\t\t\tfilters as Record<string, unknown>\n\t\t)\n\t}\n\n\t/**\n\t * Query transactions by arbitrary filter (signer, receiver, contract, function).\n\t *\n\t * All filter fields are optional; provide only the ones you want to constrain.\n\t * Returns a cursor for pagination — pass it back as `cursor` in a subsequent call.\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs, cursor } = await sdk.chain.getByFilter({\n\t *   signer: '5Kd3N...',\n\t *   contract: 'Coin',\n\t *   function: 'transfer',\n\t *   limit: 50,\n\t *   sort: 'desc'\n\t * })\n\t * ```\n\t */\n\tasync getByFilter(filters: TxByFilterParams = {}): Promise<TxByFilterResponse> {\n\t\treturn this.client.get<TxByFilterResponse>(\n\t\t\t'/api/chain/tx_by_filter',\n\t\t\tfilters as Record<string, unknown>\n\t\t)\n\t}\n\n\t/**\n\t * Get protocol-level KPIs (burned, fees, active validators/peers, total tx, UAW, etc.).\n\t *\n\t * @example\n\t * ```ts\n\t * const { kpi } = await sdk.chain.getKpi()\n\t * console.log('Total tx:', kpi.total_tx)\n\t * ```\n\t */\n\tasync getKpi(): Promise<GetKpiResponse> {\n\t\treturn this.client.get<GetKpiResponse>('/api/chain/kpi')\n\t}\n}\n"],"mappings":";;;;AAwBA,IAAa,WAAb,MAAsB;CACD;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;CAapB,MAAM,SAAkC;EACvC,OAAO,KAAK,OAAO,IAAoB,iBAAiB;;;;;;;;;;;;;CAczD,MAAM,WAAsC;EAC3C,OAAO,KAAK,OAAO,IAAsB,mBAAmB;;;;;;;;;;;;;;;CAgB7D,MAAM,UAAU,MAAc,kBAAuD;EACpF,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAuB,mBAAmB,QAAQ,EACpE,oBAAoB,kBACpB,CAAC;;;;;;;;;;;;;;CAeH,MAAM,YAAY,QAA8C;EAC/D,SAAS,OAAO,gBAAgB,OAAO;EACvC,OAAO,KAAK,OAAO,IAAyB,qBAAqB,SAAS;;;;;;;;;;;;;;CAe3E,MAAM,mBAAmB,QAA8C;EACtE,SAAS,OAAO,gBAAgB,OAAO;EACvC,OAAO,KAAK,OAAO,IAAyB,8BAA8B,SAAS;;;;;;;;;;;;;;CAepF,MAAM,eAAe,MAAoC;EACxD,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAiB,iBAAiB,OAAO;;;;;;;;;;;;;;CAe7D,MAAM,uBAAuB,WAA4D;EACxF,SAAS,kBAAkB,UAAU;EACrC,OAAO,KAAK,OAAO,IAClB,2BAA2B,YAC3B;;;;;;;;;;;;;;;;;;CAmBF,MAAM,8BACL,SACA,UAA8B,EAAE,EACiB;EACjD,SAAS,kBAAkB,QAAQ;EACnC,SAAS,0BAA0B,QAAQ;EAE3C,OAAO,KAAK,OAAO,IAClB,mCAAmC,WACnC,QACA;;;;;;;;;;;;;;;;;;;CAoBF,MAAM,YAAY,UAA4B,EAAE,EAA+B;EAC9E,OAAO,KAAK,OAAO,IAClB,2BACA,QACA;;;;;;;;;;;CAYF,MAAM,SAAkC;EACvC,OAAO,KAAK,OAAO,IAAoB,iBAAiB"}
+{"version":3,"file":"chain.js","names":[],"sources":["../../src/api/chain.ts"],"sourcesContent":["/**\n * Chain API\n *\n * Provides methods for querying blockchain data\n */\n\nimport type { AmadeusClient } from '../client'\nimport type {\n\tTransactionFilters,\n\tGetTipResponse,\n\tGetStatsResponse,\n\tGetByHashResponse,\n\tGetByHeightResponse,\n\tGetTransactionsInEntryResponse,\n\tGetTransactionEventsByAccountResponse,\n\tTransaction,\n\tTxByFilterParams,\n\tTxByFilterResponse,\n\tGetKpiResponse\n} from '../types'\nimport { Base58HashSchema, TransactionFiltersSchema } from '../schemas'\nimport { Schema } from 'effect'\nimport { validate } from '../validation'\n\nexport class ChainAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Get the current chain tip (latest entry)\n\t *\n\t * @returns Promise resolving to the latest chain entry\n\t *\n\t * @example\n\t * ```ts\n\t * const { entry } = await sdk.chain.getTip()\n\t * console.log('Current height:', entry.header.height)\n\t * ```\n\t */\n\tasync getTip(): Promise<GetTipResponse> {\n\t\treturn this.client.get<GetTipResponse>('/api/chain/tip')\n\t}\n\n\t/**\n\t * Get chain statistics\n\t *\n\t * @returns Promise resolving to chain statistics\n\t *\n\t * @example\n\t * ```ts\n\t * const { stats } = await sdk.chain.getStats()\n\t * console.log('Tip height:', stats.height)\n\t * ```\n\t */\n\tasync getStats(): Promise<GetStatsResponse> {\n\t\treturn this.client.get<GetStatsResponse>('/api/chain/stats')\n\t}\n\n\t/**\n\t * Get entry by hash\n\t *\n\t * @param hash - Entry hash (Base58 encoded)\n\t * @param filterOnFunction - Optional function filter\n\t * @returns Promise resolving to chain entry\n\t * @throws {Error} If hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entry } = await sdk.chain.getByHash('5Kd3N...')\n\t * ```\n\t */\n\tasync getByHash(hash: string, filterOnFunction?: string): Promise<GetByHashResponse> {\n\t\tvalidate(Base58HashSchema, hash)\n\t\treturn this.client.get<GetByHashResponse>(`/api/chain/hash/${hash}`, {\n\t\t\tfilter_on_function: filterOnFunction\n\t\t})\n\t}\n\n\t/**\n\t * Get entries by height\n\t *\n\t * @param height - Block height (must be >= 0)\n\t * @returns Promise resolving to chain entries at the specified height\n\t * @throws {Error} If height is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entries } = await sdk.chain.getByHeight(1000)\n\t * ```\n\t */\n\tasync getByHeight(height: number): Promise<GetByHeightResponse> {\n\t\tvalidate(Schema.NonNegativeInt, height)\n\t\treturn this.client.get<GetByHeightResponse>(`/api/chain/height/${height}`)\n\t}\n\n\t/**\n\t * Get entries by height with transactions\n\t *\n\t * @param height - Block height (must be >= 0)\n\t * @returns Promise resolving to chain entries with transactions at the specified height\n\t * @throws {Error} If height is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { entries } = await sdk.chain.getByHeightWithTxs(1000)\n\t * ```\n\t */\n\tasync getByHeightWithTxs(height: number): Promise<GetByHeightResponse> {\n\t\tvalidate(Schema.NonNegativeInt, height)\n\t\treturn this.client.get<GetByHeightResponse>(`/api/chain/height_with_txs/${height}`)\n\t}\n\n\t/**\n\t * Get a specific transaction by ID\n\t *\n\t * @param txid - Transaction ID (Base58 encoded)\n\t * @returns Promise resolving to transaction data\n\t * @throws {Error} If transaction ID is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = await sdk.chain.getTransaction('5Kd3N...')\n\t * ```\n\t */\n\tasync getTransaction(txid: string): Promise<Transaction> {\n\t\tvalidate(Base58HashSchema, txid)\n\t\treturn this.client.get<Transaction>(`/api/chain/tx/${txid}`)\n\t}\n\n\t/**\n\t * Get transactions in a specific entry\n\t *\n\t * @param entryHash - Entry hash (Base58 encoded)\n\t * @returns Promise resolving to transactions in the entry\n\t * @throws {Error} If entry hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs } = await sdk.chain.getTransactionsInEntry('5Kd3N...')\n\t * ```\n\t */\n\tasync getTransactionsInEntry(entryHash: string): Promise<GetTransactionsInEntryResponse> {\n\t\tvalidate(Base58HashSchema, entryHash)\n\t\treturn this.client.get<GetTransactionsInEntryResponse>(\n\t\t\t`/api/chain/txs_in_entry/${entryHash}`\n\t\t)\n\t}\n\n\t/**\n\t * Get transaction events by account with filtering\n\t *\n\t * @param account - Account address (Base58 encoded)\n\t * @param filters - Optional filters for transactions\n\t * @returns Promise resolving to transaction events\n\t * @throws {Error} If account address is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs, cursor } = await sdk.chain.getTransactionEventsByAccount('5Kd3N...', {\n\t *   limit: 10,\n\t *   sort: 'desc'\n\t * })\n\t * ```\n\t */\n\tasync getTransactionEventsByAccount(\n\t\taccount: string,\n\t\tfilters: TransactionFilters = {}\n\t): Promise<GetTransactionEventsByAccountResponse> {\n\t\tvalidate(Base58HashSchema, account)\n\t\tvalidate(TransactionFiltersSchema, filters)\n\n\t\treturn this.client.get<GetTransactionEventsByAccountResponse>(\n\t\t\t`/api/chain/tx_events_by_account/${account}`,\n\t\t\tfilters as Record<string, unknown>\n\t\t)\n\t}\n\n\t/**\n\t * Query transactions by arbitrary filter (signer, receiver, contract, function).\n\t *\n\t * All filter fields are optional; provide only the ones you want to constrain.\n\t * Returns a cursor for pagination — pass it back as `cursor` in a subsequent call.\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs, cursor } = await sdk.chain.getByFilter({\n\t *   signer: '5Kd3N...',\n\t *   contract: 'Coin',\n\t *   function: 'transfer',\n\t *   limit: 50,\n\t *   sort: 'desc'\n\t * })\n\t * ```\n\t */\n\tasync getByFilter(filters: TxByFilterParams = {}): Promise<TxByFilterResponse> {\n\t\treturn this.client.get<TxByFilterResponse>(\n\t\t\t'/api/chain/tx_by_filter',\n\t\t\tfilters as Record<string, unknown>\n\t\t)\n\t}\n\n\t/**\n\t * Get protocol-level KPIs (burned, fees, active validators/peers, total tx, UAW, etc.).\n\t *\n\t * @example\n\t * ```ts\n\t * const { kpi } = await sdk.chain.getKpi()\n\t * console.log('Total tx:', kpi.total_tx)\n\t * ```\n\t */\n\tasync getKpi(): Promise<GetKpiResponse> {\n\t\treturn this.client.get<GetKpiResponse>('/api/chain/kpi')\n\t}\n}\n"],"mappings":";;;;AAwBA,IAAa,WAAb,MAAsB;CACD;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;CAapB,MAAM,SAAkC;EACvC,OAAO,KAAK,OAAO,IAAoB,iBAAiB;;;;;;;;;;;;;CAczD,MAAM,WAAsC;EAC3C,OAAO,KAAK,OAAO,IAAsB,mBAAmB;;;;;;;;;;;;;;;CAgB7D,MAAM,UAAU,MAAc,kBAAuD;EACpF,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAuB,mBAAmB,QAAQ,EACpE,oBAAoB,kBACpB,CAAC;;;;;;;;;;;;;;CAeH,MAAM,YAAY,QAA8C;EAC/D,SAAS,OAAO,gBAAgB,OAAO;EACvC,OAAO,KAAK,OAAO,IAAyB,qBAAqB,SAAS;;;;;;;;;;;;;;CAe3E,MAAM,mBAAmB,QAA8C;EACtE,SAAS,OAAO,gBAAgB,OAAO;EACvC,OAAO,KAAK,OAAO,IAAyB,8BAA8B,SAAS;;;;;;;;;;;;;;CAepF,MAAM,eAAe,MAAoC;EACxD,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAiB,iBAAiB,OAAO;;;;;;;;;;;;;;CAe7D,MAAM,uBAAuB,WAA4D;EACxF,SAAS,kBAAkB,UAAU;EACrC,OAAO,KAAK,OAAO,IAClB,2BAA2B,YAC3B;;;;;;;;;;;;;;;;;;CAmBF,MAAM,8BACL,SACA,UAA8B,EAAE,EACiB;EACjD,SAAS,kBAAkB,QAAQ;EACnC,SAAS,0BAA0B,QAAQ;EAE3C,OAAO,KAAK,OAAO,IAClB,mCAAmC,WACnC,QACA;;;;;;;;;;;;;;;;;;;CAoBF,MAAM,YAAY,UAA4B,EAAE,EAA+B;EAC9E,OAAO,KAAK,OAAO,IAClB,2BACA,QACA;;;;;;;;;;;CAYF,MAAM,SAAkC;EACvC,OAAO,KAAK,OAAO,IAAoB,iBAAiB"}

package/dist/api/transaction.d.ts

@@ -14,9 +14,11 @@ declare class TransactionAPI {
    *
    * @example
    * ```ts
-   * const result = await sdk.transaction.submit(txPacked)
-   * if (result.error === 'ok') {
-   *   console.log('Transaction hash:', result.hash)
+   * try {
+   *   const { hash } = await sdk.transaction.submit(txPacked)
+   *   console.log('Transaction hash:', hash)
+   * } catch (err) {
+   *   console.error('Submission failed:', err.message)
    * }
    * ```
    */

package/dist/api/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","names":[],"sources":["../../src/api/transaction.ts"],"mappings":";;;;cAiBa,cAAA;EAAA,QACQ,MAAA;cAAA,MAAA,EAAQ,aAAA;EAiBiB;;;;;;;;;;;;;;;EAAvC,MAAA,CAAO,QAAA,EAAU,UAAA,YAAsB,OAAA,CAAQ,yBAAA;EAA9B;;;;;;;;;;;;;;;;EAqBjB,aAAA,CACL,QAAA,EAAU,UAAA,WACV,OAAA,GAAS,oBAAA,GACP,OAAA,CAAQ,gCAAA;EAqC0B;;;;;;;;;;;;EAjB/B,GAAA,CAAI,IAAA,WAAe,OAAA,CAAQ,WAAA;;;;;;;;;;;;;EAiB3B,UAAA,CAAW,SAAA,WAAoB,OAAA,CAAQ,8BAAA;AAAA"}
+{"version":3,"file":"transaction.d.ts","names":[],"sources":["../../src/api/transaction.ts"],"mappings":";;;;cAiBa,cAAA;EAAA,QACQ,MAAA;cAAA,MAAA,EAAQ,aAAA;EAmBiB;;;;;;;;;;;;;;;;;EAAvC,MAAA,CAAO,QAAA,EAAU,UAAA,YAAsB,OAAA,CAAQ,yBAAA;EAAR;;;;;;;;;;;;;;;;EAqBvC,aAAA,CACL,QAAA,EAAU,UAAA,WACV,OAAA,GAAS,oBAAA,GACP,OAAA,CAAQ,gCAAA;EAqCgE;;;;;;;;;;;;EAjBrE,GAAA,CAAI,IAAA,WAAe,OAAA,CAAQ,WAAA;;;;;;;;;;;;;EAiB3B,UAAA,CAAW,SAAA,WAAoB,OAAA,CAAQ,8BAAA;AAAA"}

package/dist/api/transaction.js

@@ -15,9 +15,11 @@ var TransactionAPI = class {
 	*
 	* @example
 	* ```ts
-	* const result = await sdk.transaction.submit(txPacked)
-	* if (result.error === 'ok') {
-	*   console.log('Transaction hash:', result.hash)
+	* try {
+	*   const { hash } = await sdk.transaction.submit(txPacked)
+	*   console.log('Transaction hash:', hash)
+	* } catch (err) {
+	*   console.error('Submission failed:', err.message)
 	* }
 	* ```
 	*/

package/dist/api/transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.js","names":[],"sources":["../../src/api/transaction.ts"],"sourcesContent":["/**\n * Transaction API\n *\n * Provides methods for submitting transactions and querying transaction data\n */\n\nimport type { AmadeusClient } from '../client'\nimport type {\n\tSubmitTransactionResponse,\n\tSubmitAndWaitTransactionResponse,\n\tSubmitAndWaitOptions,\n\tGetTransactionsInEntryResponse,\n\tTransaction\n} from '../types'\nimport { Base58HashSchema, TransactionDataSchema } from '../schemas'\nimport { validate } from '../validation'\n\nexport class TransactionAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Submit a transaction to the network\n\t *\n\t * @param txPacked - Packed transaction as Uint8Array or Base58 string\n\t * @returns Promise resolving to submission result\n\t * @throws {AmadeusSDKError} If transaction data is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const result = await sdk.transaction.submit(txPacked)\n\t * if (result.error === 'ok') {\n\t *   console.log('Transaction hash:', result.hash)\n\t * }\n\t * ```\n\t */\n\tasync submit(txPacked: Uint8Array | string): Promise<SubmitTransactionResponse> {\n\t\tvalidate(TransactionDataSchema, txPacked)\n\t\treturn this.client.post<SubmitTransactionResponse>('/api/tx/submit', txPacked)\n\t}\n\n\t/**\n\t * Submit a transaction and wait for confirmation.\n\t *\n\t * Pass `{ finalized: true }` to wait for finality (consensus reached) instead\n\t * of just confirmation. Default behavior is to return as soon as the tx is\n\t * included in an entry.\n\t *\n\t * @example\n\t * ```ts\n\t * // Wait for confirmation only (fast)\n\t * const result = await sdk.transaction.submitAndWait(txPacked)\n\t *\n\t * // Wait for finality (slower but stronger guarantee)\n\t * const finalized = await sdk.transaction.submitAndWait(txPacked, { finalized: true })\n\t * ```\n\t */\n\tasync submitAndWait(\n\t\ttxPacked: Uint8Array | string,\n\t\toptions: SubmitAndWaitOptions = {}\n\t): Promise<SubmitAndWaitTransactionResponse> {\n\t\tvalidate(TransactionDataSchema, txPacked)\n\t\tconst endpoint = options.finalized\n\t\t\t? '/api/tx/submit_and_wait?finalized=true'\n\t\t\t: '/api/tx/submit_and_wait'\n\t\treturn this.client.post<SubmitAndWaitTransactionResponse>(endpoint, txPacked)\n\t}\n\n\t/**\n\t * Get transaction by ID\n\t *\n\t * @param txid - Transaction ID (Base58 encoded)\n\t * @returns Promise resolving to transaction data\n\t * @throws {AmadeusSDKError} If transaction ID is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = await sdk.transaction.get('5Kd3N...')\n\t * ```\n\t */\n\tasync get(txid: string): Promise<Transaction> {\n\t\tvalidate(Base58HashSchema, txid)\n\t\treturn this.client.get<Transaction>(`/api/chain/tx/${txid}`)\n\t}\n\n\t/**\n\t * Get transactions by entry hash\n\t *\n\t * @param entryHash - Entry hash (Base58 encoded)\n\t * @returns Promise resolving to transactions in the entry\n\t * @throws {AmadeusSDKError} If entry hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs } = await sdk.transaction.getByEntry('5Kd3N...')\n\t * ```\n\t */\n\tasync getByEntry(entryHash: string): Promise<GetTransactionsInEntryResponse> {\n\t\tvalidate(Base58HashSchema, entryHash)\n\t\treturn this.client.get<GetTransactionsInEntryResponse>(\n\t\t\t`/api/chain/txs_in_entry/${entryHash}`\n\t\t)\n\t}\n}\n"],"mappings":";;;AAiBA,IAAa,iBAAb,MAA4B;CACP;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;;;;;CAiBpB,MAAM,OAAO,UAAmE;EAC/E,SAAS,uBAAuB,SAAS;EACzC,OAAO,KAAK,OAAO,KAAgC,kBAAkB,SAAS;;;;;;;;;;;;;;;;;;CAmB/E,MAAM,cACL,UACA,UAAgC,EAAE,EACU;EAC5C,SAAS,uBAAuB,SAAS;EACzC,MAAM,WAAW,QAAQ,YACtB,2CACA;EACH,OAAO,KAAK,OAAO,KAAuC,UAAU,SAAS;;;;;;;;;;;;;;CAe9E,MAAM,IAAI,MAAoC;EAC7C,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAiB,iBAAiB,OAAO;;;;;;;;;;;;;;CAe7D,MAAM,WAAW,WAA4D;EAC5E,SAAS,kBAAkB,UAAU;EACrC,OAAO,KAAK,OAAO,IAClB,2BAA2B,YAC3B"}
+{"version":3,"file":"transaction.js","names":[],"sources":["../../src/api/transaction.ts"],"sourcesContent":["/**\n * Transaction API\n *\n * Provides methods for submitting transactions and querying transaction data\n */\n\nimport type { AmadeusClient } from '../client'\nimport type {\n\tSubmitTransactionResponse,\n\tSubmitAndWaitTransactionResponse,\n\tSubmitAndWaitOptions,\n\tGetTransactionsInEntryResponse,\n\tTransaction\n} from '../types'\nimport { Base58HashSchema, TransactionDataSchema } from '../schemas'\nimport { validate } from '../validation'\n\nexport class TransactionAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Submit a transaction to the network\n\t *\n\t * @param txPacked - Packed transaction as Uint8Array or Base58 string\n\t * @returns Promise resolving to submission result\n\t * @throws {AmadeusSDKError} If transaction data is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * try {\n\t *   const { hash } = await sdk.transaction.submit(txPacked)\n\t *   console.log('Transaction hash:', hash)\n\t * } catch (err) {\n\t *   console.error('Submission failed:', err.message)\n\t * }\n\t * ```\n\t */\n\tasync submit(txPacked: Uint8Array | string): Promise<SubmitTransactionResponse> {\n\t\tvalidate(TransactionDataSchema, txPacked)\n\t\treturn this.client.post<SubmitTransactionResponse>('/api/tx/submit', txPacked)\n\t}\n\n\t/**\n\t * Submit a transaction and wait for confirmation.\n\t *\n\t * Pass `{ finalized: true }` to wait for finality (consensus reached) instead\n\t * of just confirmation. Default behavior is to return as soon as the tx is\n\t * included in an entry.\n\t *\n\t * @example\n\t * ```ts\n\t * // Wait for confirmation only (fast)\n\t * const result = await sdk.transaction.submitAndWait(txPacked)\n\t *\n\t * // Wait for finality (slower but stronger guarantee)\n\t * const finalized = await sdk.transaction.submitAndWait(txPacked, { finalized: true })\n\t * ```\n\t */\n\tasync submitAndWait(\n\t\ttxPacked: Uint8Array | string,\n\t\toptions: SubmitAndWaitOptions = {}\n\t): Promise<SubmitAndWaitTransactionResponse> {\n\t\tvalidate(TransactionDataSchema, txPacked)\n\t\tconst endpoint = options.finalized\n\t\t\t? '/api/tx/submit_and_wait?finalized=true'\n\t\t\t: '/api/tx/submit_and_wait'\n\t\treturn this.client.post<SubmitAndWaitTransactionResponse>(endpoint, txPacked)\n\t}\n\n\t/**\n\t * Get transaction by ID\n\t *\n\t * @param txid - Transaction ID (Base58 encoded)\n\t * @returns Promise resolving to transaction data\n\t * @throws {AmadeusSDKError} If transaction ID is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = await sdk.transaction.get('5Kd3N...')\n\t * ```\n\t */\n\tasync get(txid: string): Promise<Transaction> {\n\t\tvalidate(Base58HashSchema, txid)\n\t\treturn this.client.get<Transaction>(`/api/chain/tx/${txid}`)\n\t}\n\n\t/**\n\t * Get transactions by entry hash\n\t *\n\t * @param entryHash - Entry hash (Base58 encoded)\n\t * @returns Promise resolving to transactions in the entry\n\t * @throws {AmadeusSDKError} If entry hash is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { txs } = await sdk.transaction.getByEntry('5Kd3N...')\n\t * ```\n\t */\n\tasync getByEntry(entryHash: string): Promise<GetTransactionsInEntryResponse> {\n\t\tvalidate(Base58HashSchema, entryHash)\n\t\treturn this.client.get<GetTransactionsInEntryResponse>(\n\t\t\t`/api/chain/txs_in_entry/${entryHash}`\n\t\t)\n\t}\n}\n"],"mappings":";;;AAiBA,IAAa,iBAAb,MAA4B;CACP;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;;;;;;;CAmBpB,MAAM,OAAO,UAAmE;EAC/E,SAAS,uBAAuB,SAAS;EACzC,OAAO,KAAK,OAAO,KAAgC,kBAAkB,SAAS;;;;;;;;;;;;;;;;;;CAmB/E,MAAM,cACL,UACA,UAAgC,EAAE,EACU;EAC5C,SAAS,uBAAuB,SAAS;EACzC,MAAM,WAAW,QAAQ,YACtB,2CACA;EACH,OAAO,KAAK,OAAO,KAAuC,UAAU,SAAS;;;;;;;;;;;;;;CAe9E,MAAM,IAAI,MAAoC;EAC7C,SAAS,kBAAkB,KAAK;EAChC,OAAO,KAAK,OAAO,IAAiB,iBAAiB,OAAO;;;;;;;;;;;;;;CAe7D,MAAM,WAAW,WAA4D;EAC5E,SAAS,kBAAkB,UAAU;EACrC,OAAO,KAAK,OAAO,IAClB,2BAA2B,YAC3B"}

package/dist/constants.d.ts

@@ -7,7 +7,7 @@
 /**
  * SDK version
  */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.1.2";
 /**
  * Byte length of an Amadeus public key (BLS12-381 public key)
  */

package/dist/constants.js

@@ -7,7 +7,7 @@
 /**
 * SDK version
 */
-const SDK_VERSION = "1.0.0";
+const SDK_VERSION = "1.1.2";
 /**
 * Byte length of an Amadeus public key (BLS12-381 public key)
 */

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Amadeus Protocol Constants\n *\n * This module contains all protocol-level constants used throughout the SDK.\n */\n\n/**\n * SDK version\n */\nexport const SDK_VERSION = '1.0.0'\n\n/**\n * Byte length of an Amadeus public key (BLS12-381 public key)\n */\nexport const AMADEUS_PUBLIC_KEY_BYTE_LENGTH = 48\n\n/**\n * Byte length of an Amadeus seed (private key seed)\n */\nexport const AMADEUS_SEED_BYTE_LENGTH = 64\n\n/**\n * Number of decimal places for AMA token\n */\nexport const AMA_TOKEN_DECIMALS = 9\n\n/**\n * Multiplier for converting between atomic units and AMA tokens\n */\nexport const AMA_TOKEN_DECIMALS_MULTIPLIER = 10 ** AMA_TOKEN_DECIMALS\n\n/**\n * Minimum transferable amount in AMA (1 atomic unit)\n */\nexport const MIN_TRANSFERABLE_AMOUNT = 1 / AMA_TOKEN_DECIMALS_MULTIPLIER\n\n/**\n * Flat network transfer fee in AMA for standard transfers\n */\nexport const AMA_TRANSFER_FEE = 0.02\n\n/**\n * Default explorer URL\n */\nexport const EXPLORER_URL = 'https://explorer.ama.one'\n\n/**\n * Default node API URL\n */\nexport const NODE_API_URL = 'https://mainnet-rpc.ama.one/api'\n\n/**\n * Default request timeout in milliseconds\n */\nexport const DEFAULT_TIMEOUT = 30000\n"],"mappings":";;;;;;;;;AASA,MAAa,cAAc;;;;AAK3B,MAAa,iCAAiC;;;;AAK9C,MAAa,2BAA2B;;;;AAKxC,MAAa,qBAAqB;;;;AAKlC,MAAa,gCAAgC,MAAA;;;;AAK7C,MAAa,0BAA0B,IAAI;;;;AAK3C,MAAa,mBAAmB;;;;AAKhC,MAAa,eAAe;;;;AAK5B,MAAa,eAAe;;;;AAK5B,MAAa,kBAAkB"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Amadeus Protocol Constants\n *\n * This module contains all protocol-level constants used throughout the SDK.\n */\n\n/**\n * SDK version\n */\nexport const SDK_VERSION = '1.1.2'\n\n/**\n * Byte length of an Amadeus public key (BLS12-381 public key)\n */\nexport const AMADEUS_PUBLIC_KEY_BYTE_LENGTH = 48\n\n/**\n * Byte length of an Amadeus seed (private key seed)\n */\nexport const AMADEUS_SEED_BYTE_LENGTH = 64\n\n/**\n * Number of decimal places for AMA token\n */\nexport const AMA_TOKEN_DECIMALS = 9\n\n/**\n * Multiplier for converting between atomic units and AMA tokens\n */\nexport const AMA_TOKEN_DECIMALS_MULTIPLIER = 10 ** AMA_TOKEN_DECIMALS\n\n/**\n * Minimum transferable amount in AMA (1 atomic unit)\n */\nexport const MIN_TRANSFERABLE_AMOUNT = 1 / AMA_TOKEN_DECIMALS_MULTIPLIER\n\n/**\n * Flat network transfer fee in AMA for standard transfers\n */\nexport const AMA_TRANSFER_FEE = 0.02\n\n/**\n * Default explorer URL\n */\nexport const EXPLORER_URL = 'https://explorer.ama.one'\n\n/**\n * Default node API URL\n */\nexport const NODE_API_URL = 'https://mainnet-rpc.ama.one/api'\n\n/**\n * Default request timeout in milliseconds\n */\nexport const DEFAULT_TIMEOUT = 30000\n"],"mappings":";;;;;;;;;AASA,MAAa,cAAc;;;;AAK3B,MAAa,iCAAiC;;;;AAK9C,MAAa,2BAA2B;;;;AAKxC,MAAa,qBAAqB;;;;AAKlC,MAAa,gCAAgC,MAAA;;;;AAK7C,MAAa,0BAA0B,IAAI;;;;AAK3C,MAAa,mBAAmB;;;;AAKhC,MAAa,eAAe;;;;AAK5B,MAAa,eAAe;;;;AAK5B,MAAa,kBAAkB"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ANRInfo, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, Contract, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DecodedValue, EmissionAddress, EpochScore, EpochScoreAll, EpochScoreSingle, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, PeerInfo, ProofValidators, RichlistEntry, SerializableValue, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TokenBalance, Transaction, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidatorProofData, ValidatorProofNode, WalletBalance, WalletBalances } from "./types.js";
+import { ANRInfo, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, Contract, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DecodedValue, EmissionAddress, EpochScore, EpochScoreAll, EpochScoreSingle, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, PeerInfo, ProofValidators, RichlistEntry, SerializableValue, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TokenBalance, Transaction, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidatorProofData, ValidatorProofNode, WalletBalance } from "./types.js";
 import { AMADEUS_PUBLIC_KEY_BYTE_LENGTH, AMADEUS_SEED_BYTE_LENGTH, AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER, AMA_TRANSFER_FEE, DEFAULT_TIMEOUT, EXPLORER_URL, MIN_TRANSFERABLE_AMOUNT, NODE_API_URL, SDK_VERSION } from "./constants.js";
 import { NETWORK_CONFIGS, NETWORK_EXPLORER_URLS, NETWORK_URLS, NetworkConfig, NetworkType, TESTNET_FAUCET_URL } from "./networks.js";
 import { decode, decodeContractState, encode } from "./serialization.js";
@@ -39,4 +39,4 @@ import { parseLockupVaultData, parseRawLockupVaultData } from "./contracts/locku
 import { buildLockupVaultKeyPrefix, extractLockupVaultIndexFromKey } from "./contracts/lockup/storage-keys.js";
 import { NFT_ABI } from "./contracts/nft/abi.js";
 import { buildNftCreateCollection, buildNftMint, buildNftTransfer } from "./contracts/nft/helpers.js";
-export { AMADEUS_PUBLIC_KEY_BYTE_LENGTH, AMADEUS_SEED_BYTE_LENGTH, AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER, AMA_TRANSFER_FEE, ANRInfo, AbiDefinition, AbiFunction, AbiInput, AmadeusClient, AmadeusSDK, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainAPI, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, CoinTransferParams, Contract, ContractAPI, ContractCall, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DEFAULT_TIMEOUT, DecodedValue, EXPLORER_URL, EmissionAddress, EncryptedPayload, EpochAPI, EpochScore, EpochScoreAll, EpochScoreSingle, ExplorerType, ExtractContractName, ExtractFunctionNames, FunctionParams, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LOCKUP_ABI, LOCKUP_PRIME_ABI, LOCKUP_PRIME_TIER_KEYS, Lockup, LockupAbiError, LockupAbiFunction, LockupAbiInput, LockupAbiOutput, LockupAbiStorage, LockupAbiStorageKey, LockupAbiStorageRead, LockupAbiStorageWrite, LockupPrime, LockupPrimeAbiConstant, LockupPrimeAbiError, LockupPrimeAbiFunction, LockupPrimeAbiInput, LockupPrimeAbiOutput, LockupPrimeAbiStorage, LockupPrimeAbiStorageKey, LockupPrimeAbiStorageRead, LockupPrimeAbiStorageWrite, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeTierKey, LockupPrimeUnlockInput, LockupPrimeVault, LockupPrimeVaultSchema, LockupTier, LockupTiersSchema, LockupUnlockInput, LockupVault, LockupVaultSchema, MIN_TRANSFERABLE_AMOUNT, NETWORK_CONFIGS, NETWORK_EXPLORER_URLS, NETWORK_URLS, NFT_ABI, NODE_API_URL, NetworkConfig, NetworkType, NftCreateCollectionInput, NftCreateCollectionParams, NftMintInput, NftMintParams, NftTransferInput, NftTransferParams, PeerAPI, PeerInfo, ProofAPI, ProofValidators, RATE_MAP, RawLockupPrimeVaultData, RawLockupVaultData, RichlistEntry, SDK_VERSION, SerializableValue, SignedContract, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TESTNET_FAUCET_URL, TRANSACTION_EXECUTION_ERROR_MESSAGES, TRANSACTION_VALIDATION_ERROR_MESSAGES, TokenBalance, Transaction, TransactionAPI, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionBuilder, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, TypedContract, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidationResult, ValidatorProofData, ValidatorProofNode, VaultSecretData, WalletAPI, WalletBalance, WalletBalances, arrayBufferToBase64, arrayBufferToUint8Array, base64ToArrayBuffer, base64ToUint8Array, buildCoinTransfer, buildContractCall, buildDailyStreakKey, buildLockupPrimeVaultKeyPrefix, buildLockupVaultKeyPrefix, buildNextCheckinEpochKey, buildNftCreateCollection, buildNftMint, buildNftTransfer, createContract, decode, decodeContractState, decodeContractStateToBase64, decodeVaultSecret, decryptWithPassword, deriveKey, derivePublicKeyFromSeedBase58, deriveSkAndSeed64FromBase58Seed, detectInputType, encode, encodeVaultSecret, encryptWithPassword, extractLockupPrimeVaultIndexFromKey, extractLockupVaultIndexFromKey, formatAMAAmount, formatBalance, formatBalanceWithPrivacy, formatNumber, formatShortAddress, fromAtomicAma, fromBase58, generateIV, generateKeypair, generateMnemonic, generatePrivateKey, generateSalt, getExecutionErrorMessage, getPublicKey, getTransactionErrorMessage, getValidationErrorMessage, isValidAddress, isValidAmount, isValidLockupPrimeTierKey, isValidSeed, makeAddressUrl, makeExplorerUrl, makeTransactionUrl, mnemonicToSeedBase58, parseContractStateNumber, parseLockupVaultData, parseRawLockupVaultData, parseRawVaultData, parseStateNumber, parseStateString, parseVaultData, reduce512To256LE, seed64ToKeypair, toAtomicAma, toBase58, uint8ArrayToArrayBuffer, uint8ArrayToBase64, validate, validateAddress, validateAmount, validateMnemonic, validatePassword, validateSeed, validateTokenSymbol };
+export { AMADEUS_PUBLIC_KEY_BYTE_LENGTH, AMADEUS_SEED_BYTE_LENGTH, AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER, AMA_TRANSFER_FEE, ANRInfo, AbiDefinition, AbiFunction, AbiInput, AmadeusClient, AmadeusSDK, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainAPI, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, CoinTransferParams, Contract, ContractAPI, ContractCall, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DEFAULT_TIMEOUT, DecodedValue, EXPLORER_URL, EmissionAddress, EncryptedPayload, EpochAPI, EpochScore, EpochScoreAll, EpochScoreSingle, ExplorerType, ExtractContractName, ExtractFunctionNames, FunctionParams, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LOCKUP_ABI, LOCKUP_PRIME_ABI, LOCKUP_PRIME_TIER_KEYS, Lockup, LockupAbiError, LockupAbiFunction, LockupAbiInput, LockupAbiOutput, LockupAbiStorage, LockupAbiStorageKey, LockupAbiStorageRead, LockupAbiStorageWrite, LockupPrime, LockupPrimeAbiConstant, LockupPrimeAbiError, LockupPrimeAbiFunction, LockupPrimeAbiInput, LockupPrimeAbiOutput, LockupPrimeAbiStorage, LockupPrimeAbiStorageKey, LockupPrimeAbiStorageRead, LockupPrimeAbiStorageWrite, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeTierKey, LockupPrimeUnlockInput, LockupPrimeVault, LockupPrimeVaultSchema, LockupTier, LockupTiersSchema, LockupUnlockInput, LockupVault, LockupVaultSchema, MIN_TRANSFERABLE_AMOUNT, NETWORK_CONFIGS, NETWORK_EXPLORER_URLS, NETWORK_URLS, NFT_ABI, NODE_API_URL, NetworkConfig, NetworkType, NftCreateCollectionInput, NftCreateCollectionParams, NftMintInput, NftMintParams, NftTransferInput, NftTransferParams, PeerAPI, PeerInfo, ProofAPI, ProofValidators, RATE_MAP, RawLockupPrimeVaultData, RawLockupVaultData, RichlistEntry, SDK_VERSION, SerializableValue, SignedContract, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TESTNET_FAUCET_URL, TRANSACTION_EXECUTION_ERROR_MESSAGES, TRANSACTION_VALIDATION_ERROR_MESSAGES, TokenBalance, Transaction, TransactionAPI, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionBuilder, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, TypedContract, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidationResult, ValidatorProofData, ValidatorProofNode, VaultSecretData, WalletAPI, WalletBalance, arrayBufferToBase64, arrayBufferToUint8Array, base64ToArrayBuffer, base64ToUint8Array, buildCoinTransfer, buildContractCall, buildDailyStreakKey, buildLockupPrimeVaultKeyPrefix, buildLockupVaultKeyPrefix, buildNextCheckinEpochKey, buildNftCreateCollection, buildNftMint, buildNftTransfer, createContract, decode, decodeContractState, decodeContractStateToBase64, decodeVaultSecret, decryptWithPassword, deriveKey, derivePublicKeyFromSeedBase58, deriveSkAndSeed64FromBase58Seed, detectInputType, encode, encodeVaultSecret, encryptWithPassword, extractLockupPrimeVaultIndexFromKey, extractLockupVaultIndexFromKey, formatAMAAmount, formatBalance, formatBalanceWithPrivacy, formatNumber, formatShortAddress, fromAtomicAma, fromBase58, generateIV, generateKeypair, generateMnemonic, generatePrivateKey, generateSalt, getExecutionErrorMessage, getPublicKey, getTransactionErrorMessage, getValidationErrorMessage, isValidAddress, isValidAmount, isValidLockupPrimeTierKey, isValidSeed, makeAddressUrl, makeExplorerUrl, makeTransactionUrl, mnemonicToSeedBase58, parseContractStateNumber, parseLockupVaultData, parseRawLockupVaultData, parseRawVaultData, parseStateNumber, parseStateString, parseVaultData, reduce512To256LE, seed64ToKeypair, toAtomicAma, toBase58, uint8ArrayToArrayBuffer, uint8ArrayToBase64, validate, validateAddress, validateAmount, validateMnemonic, validatePassword, validateSeed, validateTokenSymbol };

package/dist/types.d.ts

@@ -324,19 +324,24 @@ interface LockupUnlockInput {
   vaultIndex: number;
 }
 /**
- * Transaction metadata
+ * Transaction metadata (as returned by tx query endpoints).
  */
 interface TransactionMetadata {
+  /** Hash of the entry containing this tx (Base58) */
   entry_hash: string;
+  /** Height of the entry containing this tx */
   entry_height: number;
+  /** Finality status — present on `chain.getTransaction` once the tx is rooted */
+  status?: 'finalized' | string;
+  /** Direction — only present on `chain.getTransactionEventsByAccount` results */
   tx_event?: TransactionEventType;
 }
 /**
  * Transaction receipt structure
  */
 interface TransactionReceipt {
-  /** Execution result  */
-  result: TransactionExecutionError | string;
+  /** Execution result — `null` for successful txs without a return value */
+  result: TransactionExecutionError | string | null;
   /** Execution logs (array of ASCII dump strings) */
   logs: string[];
   /** Success flag */
@@ -345,10 +350,12 @@ interface TransactionReceipt {
   exec_used: string;
 }
 /**
- * Transaction result
+ * Transaction result (legacy field — `receipt` is preferred).
+ *
+ * `error` is `null` for successful txs.
  */
 interface TransactionResult {
-  error: TransactionValidationError | string;
+  error: TransactionValidationError | string | null;
 }
 /**
  * Transaction data returned from the API
@@ -396,56 +403,101 @@ interface TransactionFilters {
   type?: TransactionEventType;
 }
 /**
- * Chain entry header structure
+ * Chain entry header structure (as returned by the node).
+ *
+ * Source of truth: `format_entry_for_client/1` in `ex/lib/api/api_chain.ex`.
  */
 interface ChainEntryHeader {
-  height: number;
-  timestamp: number;
-  mutations_hash: string;
+  /** Slot number — strictly increasing, time-based */
   slot: number;
+  /** Block height (canonical chain position) */
+  height: number;
+  /** Previous slot number */
   prev_slot: number;
+  /** Previous entry hash (Base58) */
   prev_hash: string;
+  /** Data-randomness (Base58) */
   dr: string;
+  /** VRF output (Base58) */
   vr: string;
+  /** Signer's public key (Base58) */
   signer: string;
-  txs_hash: string;
+  /** Root transaction hash (Base58, optional) */
   root_tx?: string;
+  /** Root validator (Base58, optional) */
   root_validator?: string;
 }
 /**
- * Chain entry structure
+ * Chain entry structure (as returned by the node).
+ *
+ * The `height` lives at `entry.header.height`, NOT at the top level.
  */
 interface ChainEntry {
+  /** Header — height, slot, signer, etc. live here */
+  header: ChainEntryHeader;
+  /** Entry hash (Base58) */
   hash: string;
-  height: number;
-  timestamp: number;
-  mutations_hash: string;
-  tx_count?: number;
+  /** Number of transactions in this entry */
+  tx_count: number;
+  /** Validator participation mask (Base58, optional) */
   mask?: string;
+  /** Number of validators reflected in `mask` */
+  mask_size?: number;
+  /** Consensus state — present once a validator quorum is reached */
   consensus?: {
-    score: number;
-    finality_reached: boolean;
+    /** Fraction of validator weight that has signed (0–1) */score: number; /** True once score ≥ 0.67 (finalized) */
+    finality_reached: boolean; /** Mutations-hash Base58 — hash of state mutations applied by this entry */
     mut_hash: string;
   };
-  header_unpacked: ChainEntryHeader;
-}
-/**
- * Chain statistics
+  /**
+   * Hash of the next entry once finality has been reached on it.
+   * Only set on `chain.getByHash` responses.
+   */
+  next_entry_hash_finality_reached?: string;
+  /**
+   * Filtered transactions — only set on `chain.getByHash` when called with
+   * `filterOnFunction`.
+   */
+  txs_filtered?: Transaction[];
+}
+/**
+ * Chain statistics (as returned by `/api/chain/stats`).
+ *
+ * Source of truth: `API.Chain.stats/1` in `ex/lib/api/api_chain.ex`.
  */
 interface ChainStats {
+  /** Current tip height */
   height: number;
-  total_entries: number;
-  total_transactions: number;
-  tip_hash?: string;
-  tip?: ChainEntry;
-  tx_pool_size?: number;
-  cur_validator?: string;
-  next_validator?: string;
-  emission_for_epoch?: number;
-  circulating?: number;
-  total_supply_y3?: number;
-  total_supply_y30?: number;
-  pflops?: number;
+  /** Most recent finalized (rooted) height */
+  rooted_height: number;
+  /** Hash of the tip entry (Base58) */
+  tip_hash: string;
+  /** Full tip entry */
+  tip: ChainEntry;
+  /** Number of pending transactions in the mempool */
+  tx_pool_size: number;
+  /** Validator scheduled to produce the current entry (Base58) */
+  cur_validator: string;
+  /** Validator scheduled to produce the next entry (Base58) */
+  next_validator: string;
+  /** Emission for the current epoch (AMA float) */
+  emission_for_epoch: number;
+  /** Circulating supply (AMA float) */
+  circulating: number;
+  /** Total AMA burned (float) */
+  burned: number;
+  /** Projected total supply at year 3 */
+  total_supply_y3: number;
+  /** Projected total supply at year 30 */
+  total_supply_y30: number;
+  /** Current difficulty bits */
+  diff_bits: number;
+  /** Estimated PFLOPS across the validator set */
+  pflops: number;
+  /** Recent throughput estimate (transactions per second) */
+  txs_per_sec: number;
+  /** Current segment VRF hash (Base58) */
+  segment_vr_hash: string;
 }
 /**
  * Token balance structure
@@ -465,16 +517,6 @@ interface WalletBalance {
     symbol: string;
   };
 }
-/**
- * Wallet balances map
- */
-interface WalletBalances {
-  [symbol: string]: {
-    float: number;
-    flat: number;
-    symbol: string;
-  };
-}
 /**
  * Contract data value can be any JSON-serializable value
  */
@@ -490,20 +532,28 @@ interface ContractData {
   value: ContractDataValue;
 }
 /**
- * Richlist entry structure
+ * Richlist entry structure (as returned by `/api/contract/richlist`).
+ * Source of truth: `API.Contract.richlist/0` in `ex/lib/api/api_contract.ex`.
  */
 interface RichlistEntry {
-  address: string;
-  balance: string;
+  /** Account public key (Base58) */
+  pk: string;
+  /** Token symbol (always 'AMA' for now) */
   symbol: string;
-  rank: number;
+  /** Balance in atomic units */
+  flat: number;
+  /** Balance in human-readable units */
+  float: number;
 }
 /**
- * Epoch score structure
+ * Epoch score structure.
+ *
+ * The all-validators variant returns a tuple array `[pk, score][]`.
+ * The single-pk variant returns `{ score }` (the SDK strips the `error: 'ok'`
+ * wrapper).
  */
 type EpochScoreAll = [string, number][];
 type EpochScoreSingle = {
-  error: 'ok';
   score: number;
 };
 type EpochScore = EpochScoreAll | EpochScoreSingle;
@@ -613,26 +663,45 @@ interface GetWalletTransactionsResponse {
   cursor: string;
   txs: Transaction[];
 }
+/**
+ * Response from `/api/wallet/balance_all/{pk}`.
+ * The node returns balances as an array of `{ float, symbol, flat }` entries.
+ */
 interface GetAllBalancesResponse {
-  error?: string;
-  balances: TokenBalance[] | WalletBalances;
+  balances: TokenBalance[];
 }
+/**
+ * Response from `/api/contract/validate`.
+ *
+ * Always returns the validation result and any logs emitted by the validator.
+ * Note: the node currently returns `error: 'ok'` on success, which the SDK
+ * strips — making `error` undefined when validation succeeds. Check `logs`
+ * for diagnostic output regardless.
+ */
 interface ValidateBytecodeResponse {
-  error: string;
+  /** Validation error code, if any (undefined on success after SDK strips `:ok`) */
+  error?: string;
+  /** Validator logs (ASCII-dumped) */
+  logs?: string[];
 }
 interface GetRichlistResponse {
   richlist: RichlistEntry[];
 }
+/**
+ * Response from `/api/epoch/get_emission_address/{pk}`.
+ * The `error: 'ok'` envelope is stripped by the SDK.
+ */
 interface GetEmissionAddressResponse {
-  error: 'ok';
+  /** Configured emission address (Base58), or `null` if not set */
   emission_address: string | null;
 }
 /**
- * Response for checking if solution is in epoch
+ * Response from `/api/epoch/sol_in_epoch/{epoch}/{solHash}`.
+ *
+ * Empty object on success. The SDK throws `AmadeusSDKError` for
+ * `invalid_epoch` / `sol_not_found` (caller can distinguish by `error.message`).
  */
-interface GetSolInEpochResponse {
-  error: 'ok' | 'invalid_epoch' | 'sol_not_found';
-}
+type GetSolInEpochResponse = Record<string, never>;
 interface GetNodesResponse {
   nodes: PeerInfo[];
 }
@@ -654,18 +723,29 @@ interface GetANRByPkResponse {
 interface SubmitTransactionRequestQuery {
   txPacked: Uint8Array;
 }
+/**
+ * Response from `/api/tx/submit` on success.
+ *
+ * The SDK strips the `error: 'ok'` envelope and throws `AmadeusSDKError`
+ * on validation failure — so this success type contains only the hash.
+ */
 interface SubmitTransactionResponse {
-  error: TransactionValidationError | string;
-  hash?: string;
+  /** Submitted transaction hash (Base58) */
+  hash: string;
 }
 /**
- * Response for submit and wait transaction
+ * Response from `/api/tx/submit_and_wait` on success.
+ *
+ * The SDK strips the `error: 'ok'` envelope and throws `AmadeusSDKError`
+ * on validation failure or wait timeout.
  */
 interface SubmitAndWaitTransactionResponse {
-  error: TransactionValidationError | string;
-  hash?: string;
-  metadata?: TransactionMetadata;
-  receipt?: TransactionReceipt;
+  /** Submitted transaction hash (Base58) */
+  hash: string;
+  /** Metadata about the entry containing the tx */
+  metadata: TransactionMetadata;
+  /** Execution receipt */
+  receipt: TransactionReceipt;
 }
 /**
  * Validator proof response structure
@@ -757,5 +837,5 @@ interface SubmitAndWaitOptions {
   finalized?: boolean;
 }
 //#endregion
-export { ANRInfo, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, Contract, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DecodedValue, EmissionAddress, EpochScore, EpochScoreAll, EpochScoreSingle, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, PeerInfo, ProofValidators, RichlistEntry, SerializableValue, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TokenBalance, Transaction, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidatorProofData, ValidatorProofNode, WalletBalance, WalletBalances };
+export { ANRInfo, AmadeusSDKConfig, AmadeusSDKError, ApiResponse, BuildTransactionResult, ChainEntry, ChainEntryHeader, ChainKpi, ChainStats, Contract, ContractData, ContractDataValue, ContractFunction, ContractStateProof, ContractViewParams, ContractViewResponse, DecodedValue, EmissionAddress, EpochScore, EpochScoreAll, EpochScoreSingle, GetANRByPkResponse, GetANRsResponse, GetAllBalancesResponse, GetByHashResponse, GetByHeightResponse, GetEmissionAddressResponse, GetKpiResponse, GetNodesResponse, GetRemovedTrainersResponse, GetRichlistResponse, GetSolInEpochResponse, GetStatsResponse, GetTipResponse, GetTokenBalanceQuery, GetTokenBalanceResponse, GetTrainersResponse, GetTransactionEventsByAccountResponse, GetTransactionsInEntryResponse, GetWalletTransactionsQuery, GetWalletTransactionsResponse, KeyPair, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, PeerInfo, ProofValidators, RichlistEntry, SerializableValue, SubmitAndWaitOptions, SubmitAndWaitTransactionResponse, SubmitTransactionRequestQuery, SubmitTransactionResponse, TokenBalance, Transaction, TransactionAction, TransactionActionBody, TransactionActionResponse, TransactionBody, TransactionEvent, TransactionEventType, TransactionExecutionError, TransactionFilters, TransactionMetadata, TransactionPacked, TransactionReceipt, TransactionResult, TransactionUnpacked, TransactionValidationError, TransactionValidationResult, TransferTransactionInput, TxByFilterParams, TxByFilterResponse, UnsignedTransaction, UnsignedTransactionWithHash, ValidateBytecodeResponse, ValidatorProofData, ValidatorProofNode, WalletBalance };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Type Definitions\n *\n * This module contains all TypeScript type definitions used throughout the SDK.\n */\n\n// ============================================================================\n// Core Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Serialization Types\n// ----------------------------------------------------------------------------\n\n/**\n * Serializable value types for canonical encoding (VecPack)\n */\nexport type SerializableValue =\n\t| null\n\t| boolean\n\t| number\n\t| bigint\n\t| string\n\t| Uint8Array\n\t| SerializableValue[]\n\t| Map<SerializableValue, SerializableValue>\n\t| { [key: string]: SerializableValue }\n\n/**\n * Decoded value types (Map is returned for objects during decode)\n */\nexport type DecodedValue =\n\t| null\n\t| boolean\n\t| bigint\n\t| Uint8Array\n\t| DecodedValue[]\n\t| Map<DecodedValue, DecodedValue>\n\n// ----------------------------------------------------------------------------\n// Cryptographic Types\n// ----------------------------------------------------------------------------\n\n/**\n * Key pair structure containing public and private keys as Base58 strings\n */\nexport interface KeyPair {\n\t/** Base58 encoded public key */\n\tpublicKey: string\n\t/** Base58 encoded private key (seed) */\n\tprivateKey: string\n}\n\n// ----------------------------------------------------------------------------\n// API Client Types\n// ----------------------------------------------------------------------------\n\n/**\n * SDK configuration\n */\nexport interface AmadeusSDKConfig {\n\t/** Base URL of the Amadeus node API (defaults to NODE_API_URL) */\n\tbaseUrl?: string\n\t/** Request timeout in milliseconds (default: 30000) */\n\ttimeout?: number\n\t/** Custom headers to include in requests */\n\theaders?: Record<string, string>\n}\n\n/**\n * API response wrapper\n * Note: Index signature needed for dynamic response properties\n */\nexport interface ApiResponse {\n\terror: 'ok' | 'not_found' | string\n\t[key: string]: unknown\n}\n\n/**\n * SDK error class\n */\nexport class AmadeusSDKError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status?: number,\n\t\tpublic response?: Record<string, unknown>\n\t) {\n\t\tsuper(message)\n\t\tthis.name = 'AmadeusSDKError'\n\t}\n}\n\n// ============================================================================\n// Enums\n// ============================================================================\n\n/**\n * Transaction validation error codes\n */\nexport enum TransactionValidationError {\n\tOK = 'ok',\n\tTOO_LARGE = 'too_large',\n\tTX_NOT_CANONICAL = 'tx_not_canonical',\n\tINVALID_HASH = 'invalid_hash',\n\tINVALID_SIGNATURE = 'invalid_signature',\n\tNONCE_NOT_INTEGER = 'nonce_not_integer',\n\tNONCE_TOO_HIGH = 'nonce_too_high',\n\tACTIONS_MUST_BE_LIST = 'actions_must_be_list',\n\tACTIONS_LENGTH_MUST_BE_1 = 'actions_length_must_be_1',\n\tOP_MUST_BE_CALL = 'op_must_be_call',\n\tCONTRACT_MUST_BE_BINARY = 'contract_must_be_binary',\n\tFUNCTION_MUST_BE_BINARY = 'function_must_be_binary',\n\tARGS_MUST_BE_LIST = 'args_must_be_list',\n\tARG_MUST_BE_BINARY = 'arg_must_be_binary',\n\tINVALID_MODULE = 'invalid_module',\n\tINVALID_FUNCTION = 'invalid_function',\n\tINVALID_MODULE_FOR_SPECIAL_MEETING = 'invalid_module_for_special_meeting',\n\tINVALID_FUNCTION_FOR_SPECIAL_MEETING = 'invalid_function_for_special_meeting',\n\tUNKNOWN = 'unknown'\n}\n\n/**\n * Transaction execution error codes.\n * These are returned when contract execution fails.\n */\nexport enum TransactionExecutionError {\n\t/** Success - execution completed successfully */\n\tOK = 'ok',\n\t/** Unknown error (when panic payload cannot be converted to string) */\n\tUNKNOWN = 'unknown',\n\t/** Contract execution was aborted */\n\tAS_ABORT = 'as_abort',\n\n\t// Execution budget errors\n\tEXEC_INVALID_AMOUNT_NEGATIVE = 'exec_invalid_amount_negative',\n\tEXEC_INSUFFICIENT_EXEC_BUDGET = 'exec_insufficient_exec_budget',\n\tEXEC_CRITICAL_UNDERFLOW = 'exec_critical_underflow',\n\n\t// Storage budget errors\n\tEXEC_STORAGE_INVALID_AMOUNT_NEGATIVE = 'exec_storage_invalid_amount_negative',\n\tEXEC_INSUFFICIENT_STORAGE_BUDGET = 'exec_insufficient_storage_budget',\n\tEXEC_STORAGE_CRITICAL_UNDERFLOW = 'exec_storage_critical_underflow',\n\n\t// KV operation errors\n\tEXEC_TOO_LARGE_KEY_SIZE = 'exec_too_large_key_size',\n\tEXEC_TOO_LARGE_VALUE_SIZE = 'exec_too_large_value_size',\n\tEXEC_KV_PUT_FAILED = 'exec_kv_put_failed',\n\tEXEC_KV_INCREMENT_FAILED = 'exec_kv_increment_failed',\n\tEXEC_KV_INCREMENT_INVALID_INTEGER = 'exec_kv_increment_invalid_integer',\n\tEXEC_KV_INCREMENT_INTEGER_OVERFLOW = 'exec_kv_increment_integer_overflow',\n\tKV_PUT_FAILED = 'kv_put_failed',\n\tEXEC_KV_DELETE_FAILED = 'exec_kv_delete_failed',\n\tEXEC_KV_SET_BIT_FAILED = 'exec_kv_set_bit_failed',\n\tEXEC_CANNOT_WRITE_DURING_VIEW = 'exec_cannot_write_during_view',\n\n\t// WASM execution errors\n\tEXEC_RETURN_VALUE_TOO_LARGE = 'exec_return_value_too_large',\n\tEXEC_INSTANCE_NOT_INJECTED = 'exec_instance_not_injected',\n\tEXEC_PTR_TERM_TOO_SHORT = 'exec_ptr_term_too_short',\n\tEXEC_PTR_TERM_TOO_LONG = 'exec_ptr_term_too_long',\n\tEXEC_LOG_INVALID_PTR = 'exec_log_invalid_ptr',\n\tEXEC_CALL_TABLE_INVALID_PTR = 'exec_call_table_invalid_ptr',\n\tEXEC_CALL_TOO_MANY_ARGS = 'exec_call_too_many_args',\n\tEXEC_READ_CALL_TABLE_ERROR = 'exec_read_call_table_error',\n\tEXEC_CALL_PTR_TERM_TOO_LONG = 'exec_call_ptr_term_too_long',\n\tEXEC_READ_CALL_TABLE_DATA_ERROR = 'exec_read_call_table_data_error',\n\tEXEC_CALL_EXTRA_INVALID = 'exec_call_extra_invalid',\n\tEXEC_CALL_EXTRA_TOO_MANY = 'exec_call_extra_too_many',\n\tEXEC_READ_EXTRA_ROW = 'exec_read_extra_row',\n\tEXEC_READ_EXTRA_DATA = 'exec_read_extra_data',\n\tEXEC_CALL_MISSING_ARGS = 'exec_call_missing_args',\n\tEXEC_MEMWRITE = 'exec_memwrite',\n\tEXEC_LOG_MSG_SIZE_EXCEEDED = 'exec_log_msg_size_exceeded',\n\tEXEC_LOGS_TOTAL_SIZE_EXCEEDED = 'exec_logs_total_size_exceeded',\n\tEXEC_LOGS_TOTAL_ELEMENTS_EXCEEDED = 'exec_logs_total_elements_exceeded',\n\tEXEC_INVALID_MODULE = 'exec_invalid_module',\n\tEXEC_MEMORY_ALLOC = 'exec_memory_alloc',\n\tEXEC_ARG_LEN_WRITE = 'exec_arg_len_write',\n\tEXEC_ARG_WRITE = 'exec_arg_write',\n\tEXEC_INSTANCE = 'exec_instance',\n\tEXEC_INIT_MEMWRITE = 'exec_init_memwrite',\n\tEXEC_DESERIALIZE_ERR = 'exec_deserialize_err',\n\tEXEC_SERIALIZE_ERR = 'exec_serialize_err',\n\tEXEC_FUNCTION_NOT_FOUND = 'exec_function_not_found',\n\tEXEC_ERROR = 'exec_error',\n\n\t// Contract/action errors\n\tINVALID_EPOCH = 'invalid_epoch',\n\tINVALID_BIC_ACTION = 'invalid_bic_action',\n\tINVALID_FUNCTION = 'invalid_function',\n\tACCOUNT_HAS_NO_BYTECODE = 'account_has_no_bytecode',\n\tINVALID_ATTACHED_AMOUNT = 'invalid_attached_amount',\n\tATTACHED_AMOUNT_INSUFFICIENT_FUNDS = 'attached_amount_insufficient_funds',\n\tWASM_NOOP = 'wasm_noop',\n\tINVALID_BYTECODE = 'invalid_bytecode',\n\n\t// Coin contract errors\n\tINVALID_ARGS = 'invalid_args',\n\tINVALID_AMOUNT = 'invalid_amount',\n\tINVALID_RECEIVER_PK = 'invalid_receiver_pk',\n\tINSUFFICIENT_FUNDS = 'insufficient_funds',\n\tPAUSED = 'paused',\n\tSOULBOUND = 'soulbound',\n\tINVALID_BALANCE = 'invalid_balance',\n\tINVALID_TOTAL_SUPPLY = 'invalid_total_supply',\n\tINVALID_SYMBOL = 'invalid_symbol',\n\tSYMBOL_TOO_SHORT = 'symbol_too_short',\n\tSYMBOL_TOO_LONG = 'symbol_too_long',\n\tSYMBOL_RESERVED = 'symbol_reserved',\n\tSYMBOL_EXISTS = 'symbol_exists',\n\tINVALID_DECIMALS = 'invalid_decimals',\n\tNO_PERMISSIONS = 'no_permissions',\n\tSYMBOL_DOESNT_EXIST = 'symbol_doesnt_exist',\n\tNOT_MINTABLE = 'not_mintable',\n\tINVALID_DIRECTION = 'invalid_direction',\n\tNOT_PAUSABLE = 'not_pausable',\n\n\t// Lockup contract errors\n\tINVALID_DURATION = 'invalid_duration',\n\tINVALID_VAULT = 'invalid_vault',\n\tINVALID_UNLOCK_HEIGHT = 'invalid_unlock_height',\n\tINVALID_UNLOCK_AMOUNT = 'invalid_unlock_amount',\n\tVAULT_IS_LOCKED = 'vault_is_locked',\n\n\t// Lockup Prime contract errors\n\tINVALID_TIER = 'invalid_tier',\n\tINVALID_MULTIPLIER = 'invalid_multiplier',\n\tINVALID_UNLOCK_EPOCH = 'invalid_unlock_epoch',\n\tINVALID_NEXT_CHECKIN_EPOCH = 'invalid_next_checkin_epoch',\n\n\t// NFT contract errors\n\tINSUFFICIENT_TOKENS = 'insufficient_tokens',\n\tINVALID_COLLECTION = 'invalid_collection',\n\tCOLLECTION_TOO_SHORT = 'collection_too_short',\n\tCOLLECTION_TOO_LONG = 'collection_too_long',\n\tCOLLECTION_RESERVED = 'collection_reserved',\n\tCOLLECTION_EXISTS = 'collection_exists',\n\tCOLLECTION_DOESNT_EXIST = 'collection_doesnt_exist',\n\n\t// Integer parsing errors\n\tINVALID_INTEGER = 'invalid_integer'\n}\n\n/**\n * Transaction event type\n */\nexport enum TransactionEventType {\n\tSENT = 'sent',\n\tRECEIVED = 'recv'\n}\n\n/**\n * Contract names\n */\nexport enum Contract {\n\tEPOCH = 'Epoch',\n\tCOIN = 'Coin',\n\tCONTRACT = 'Contract'\n}\n\n/**\n * Contract function names\n */\nexport enum ContractFunction {\n\tTRANSFER = 'transfer',\n\tSUBMIT_SOL = 'submit_sol',\n\tSET_EMISSION_ADDRESS = 'set_emission_address',\n\tSLASH_TRAINER = 'slash_trainer',\n\tDEPLOY = 'deploy',\n\tCREATE_AND_MINT = 'create_and_mint',\n\tMINT = 'mint',\n\tPAUSE = 'pause'\n}\n\n// ============================================================================\n// Domain Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Transaction Types\n// ----------------------------------------------------------------------------\n\n/**\n * Transaction action structure (for building transactions)\n */\nexport interface TransactionAction extends Record<string, SerializableValue> {\n\top: 'call'\n\tcontract: string\n\tfunction: string\n\targs: SerializableValue[]\n}\n\n/**\n * Transaction action structure (as returned by API)\n */\nexport interface TransactionActionResponse {\n\top: 'call'\n\tcontract: string\n\tfunction: string | ContractFunction\n\targs: (string | number | boolean)[]\n\tattached_symbol?: string\n\tattached_amount?: string\n}\n\n/**\n * Transaction action structure (legacy/alternative format)\n */\nexport interface TransactionActionBody {\n\top: 'call'\n\tcontract: string\n\tfunction: ContractFunction\n\targs: (string | Uint8Array)[]\n}\n\n/**\n * Transaction body structure\n */\nexport interface TransactionBody {\n\tsigner: Uint8Array | string\n\tnonce: number\n\taction: TransactionActionBody\n}\n\n/**\n * Unsigned transaction structure\n */\nexport interface UnsignedTransaction extends Record<string, SerializableValue> {\n\tsigner: Uint8Array\n\tnonce: bigint\n\taction: TransactionAction\n}\n\n/**\n * Unsigned transaction with its hash\n */\nexport interface UnsignedTransactionWithHash {\n\t/** Unsigned transaction structure */\n\ttx: UnsignedTransaction\n\t/** Transaction hash as Uint8Array */\n\thash: Uint8Array\n}\n\n/**\n * Packed transaction type\n */\nexport type TransactionPacked = Uint8Array\n\n/**\n * Unpacked transaction structure\n */\nexport interface TransactionUnpacked {\n\ttx: TransactionBody\n\ttx_encoded: Uint8Array\n\thash: Uint8Array\n\tsignature: Uint8Array\n\tmetadata?: {\n\t\tentry_hash: Uint8Array | string\n\t\tentry_height: number\n\t\ttx_event?: TransactionEventType\n\t}\n}\n\n/**\n * Transaction validation result\n */\nexport type TransactionValidationResult =\n\t| { error: 'ok'; txu: TransactionUnpacked }\n\t| { error: TransactionValidationError }\n\n/**\n * Result of building a transaction\n */\nexport interface BuildTransactionResult {\n\t/** Transaction hash as Base58 string */\n\ttxHash: string\n\t/** Packed transaction ready for submission */\n\ttxPacked: Uint8Array\n}\n\n/**\n * Input parameters for building a transfer transaction\n */\nexport interface TransferTransactionInput {\n\t/** Base58 encoded sender private key (seed) */\n\tsenderPrivkey: string\n\t/** Base58 encoded recipient address */\n\trecipient: string\n\t/** Amount in human-readable format */\n\tamount: number\n\t/** Token symbol (e.g., 'AMA') */\n\tsymbol: string\n}\n\nexport interface LockupPrimeLockInput {\n\tsenderPrivkey: string\n\tamount: number | string\n\ttier: string\n}\n\nexport interface LockupPrimeUnlockInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\nexport interface LockupPrimeDailyCheckinInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\nexport interface LockupUnlockInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\n/**\n * Transaction metadata\n */\nexport interface TransactionMetadata {\n\tentry_hash: string\n\tentry_height: number\n\ttx_event?: TransactionEventType\n}\n\n/**\n * Transaction receipt structure\n */\nexport interface TransactionReceipt {\n\t/** Execution result  */\n\tresult: TransactionExecutionError | string\n\t/** Execution logs (array of ASCII dump strings) */\n\tlogs: string[]\n\t/** Success flag */\n\tsuccess: boolean\n\t/** Execution cost used */\n\texec_used: string\n}\n\n/**\n * Transaction result\n */\nexport interface TransactionResult {\n\terror: TransactionValidationError | string\n}\n\n/**\n * Transaction data returned from the API\n */\nexport interface Transaction {\n\t/** Transaction hash (Base58 encoded) */\n\thash: string\n\t/** Transaction signature (Base58 encoded) */\n\tsignature: string\n\t/** Transaction data */\n\ttx: {\n\t\t/** Signer's public key (Base58 encoded) */\n\t\tsigner: string\n\t\t/** Transaction nonce */\n\t\tnonce: number\n\t\t/** Transaction action */\n\t\taction: TransactionActionResponse\n\t}\n\t/** Transaction metadata */\n\tmetadata: TransactionMetadata\n\t/** Transaction result @deprecated use receipt instead */\n\tresult: TransactionResult\n\t/** Transaction receipt (execution result and logs) */\n\treceipt: TransactionReceipt\n}\n\n/**\n * Transaction event structure\n */\nexport interface TransactionEvent {\n\ttype: TransactionEventType\n\ttxid: string\n\tamount: string\n\tsymbol: string\n\ttimestamp: number\n}\n\n/**\n * Transaction filters for querying transactions\n */\nexport interface TransactionFilters {\n\tlimit?: number\n\toffset?: number\n\tsort?: 'asc' | 'desc'\n\tcursor?: string\n\tcursor_b58?: string\n\tcontract?: string | Contract\n\tcontract_b58?: string\n\tfunction?: string | ContractFunction\n\ttype?: TransactionEventType\n}\n\n// ----------------------------------------------------------------------------\n// Chain Types\n// ----------------------------------------------------------------------------\n\n/**\n * Chain entry header structure\n */\nexport interface ChainEntryHeader {\n\theight: number\n\ttimestamp: number\n\tmutations_hash: string\n\tslot: number\n\tprev_slot: number\n\tprev_hash: string\n\tdr: string\n\tvr: string\n\tsigner: string\n\ttxs_hash: string\n\troot_tx?: string\n\troot_validator?: string\n}\n\n/**\n * Chain entry structure\n */\nexport interface ChainEntry {\n\thash: string\n\theight: number\n\ttimestamp: number\n\tmutations_hash: string\n\ttx_count?: number\n\tmask?: string\n\tconsensus?: {\n\t\tscore: number\n\t\tfinality_reached: boolean\n\t\tmut_hash: string\n\t}\n\theader_unpacked: ChainEntryHeader\n}\n\n/**\n * Chain statistics\n */\nexport interface ChainStats {\n\theight: number\n\ttotal_entries: number\n\ttotal_transactions: number\n\ttip_hash?: string\n\ttip?: ChainEntry\n\ttx_pool_size?: number\n\tcur_validator?: string\n\tnext_validator?: string\n\temission_for_epoch?: number\n\tcirculating?: number\n\ttotal_supply_y3?: number\n\ttotal_supply_y30?: number\n\tpflops?: number\n}\n\n// ----------------------------------------------------------------------------\n// Wallet Types\n// ----------------------------------------------------------------------------\n\n/**\n * Token balance structure\n */\nexport interface TokenBalance {\n\tfloat: number\n\tsymbol: string\n\tflat: number\n}\n\n/**\n * Wallet balance wrapper\n */\nexport interface WalletBalance {\n\tbalance: {\n\t\tfloat: number\n\t\tflat: number\n\t\tsymbol: string\n\t}\n}\n\n/**\n * Wallet balances map\n */\nexport interface WalletBalances {\n\t[symbol: string]: {\n\t\tfloat: number\n\t\tflat: number\n\t\tsymbol: string\n\t}\n}\n\n// ----------------------------------------------------------------------------\n// Contract Types\n// ----------------------------------------------------------------------------\n\n/**\n * Contract data value can be any JSON-serializable value\n */\nexport type ContractDataValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| ContractDataValue[]\n\t| { [key: string]: ContractDataValue }\n\n/**\n * Contract data structure\n */\nexport interface ContractData {\n\tcontract: string\n\tkey: string\n\tvalue: ContractDataValue\n}\n\n/**\n * Richlist entry structure\n */\nexport interface RichlistEntry {\n\taddress: string\n\tbalance: string\n\tsymbol: string\n\trank: number\n}\n\n// ----------------------------------------------------------------------------\n// Epoch Types\n// ----------------------------------------------------------------------------\n\n/**\n * Epoch score structure\n */\nexport type EpochScoreAll = [string, number][]\nexport type EpochScoreSingle = { error: 'ok'; score: number }\nexport type EpochScore = EpochScoreAll | EpochScoreSingle\n\n/**\n * Emission address structure\n */\nexport interface EmissionAddress {\n\taddress: string\n\tpk: string\n}\n\n// ----------------------------------------------------------------------------\n// Peer Types\n// ----------------------------------------------------------------------------\n\n/**\n * Peer information structure\n */\nexport interface PeerInfo {\n\tpk: string\n\tversion: string\n\tlatency?: number\n\ttemporal_height?: number\n\ttemporal_hash?: string\n\trooted_height?: number\n\trooted_hash?: string\n\tis_trainer?: boolean\n\tslot_speed?: number\n\tonline?: boolean\n\tin_slot?: boolean\n}\n\n/**\n * ANR (Autonomous Network Registry) information structure\n */\nexport interface ANRInfo {\n\tpk: string\n\tpop: string\n\tsignature: string\n\tip4: string\n\tport: number\n\thandshaked: boolean\n\tisChainPop: boolean\n\tversion: string\n\tts: number\n}\n\n// ----------------------------------------------------------------------------\n// Proof Types\n// ----------------------------------------------------------------------------\n\n/**\n * Validator proof node structure\n */\nexport interface ValidatorProofNode {\n\tdirection: string\n\thash: string\n}\n\n/**\n * Validator proof data structure\n */\nexport interface ValidatorProofData {\n\troot: string\n\tpath: string\n\thash: string\n\tnodes: ValidatorProofNode[]\n}\n\n// ============================================================================\n// API Response Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Chain API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface GetTipResponse {\n\tentry: ChainEntry\n}\n\nexport interface GetStatsResponse {\n\tstats: ChainStats\n}\n\nexport interface GetByHashResponse {\n\tentry: ChainEntry\n}\n\nexport interface GetByHeightResponse {\n\tentries: ChainEntry[]\n}\n\nexport interface GetTransactionEventsByAccountResponse {\n\tcursor: string\n\ttxs: TransactionEvent[]\n}\n\nexport interface GetTransactionsInEntryResponse {\n\ttxs: Transaction[]\n}\n\n// ----------------------------------------------------------------------------\n// Wallet API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Query parameters for getting token balance\n */\nexport interface GetTokenBalanceQuery {\n\taddress: string\n\tsymbol?: string\n}\n\n/**\n * Response for getting token balance\n */\nexport interface GetTokenBalanceResponse {\n\terror: string\n\tdata: TokenBalance\n}\n\n/**\n * Query parameters for getting wallet transactions\n */\nexport interface GetWalletTransactionsQuery {\n\taddress: string\n\tcontract?: Contract\n\tfunction?: ContractFunction\n\ttype?: TransactionEventType\n\tsort?: 'asc' | 'desc'\n\tlimit?: number\n\toffset?: number\n\tcursor?: string\n}\n\n/**\n * Response for getting wallet transactions\n */\nexport interface GetWalletTransactionsResponse {\n\tcursor: string\n\ttxs: Transaction[]\n}\n\nexport interface GetAllBalancesResponse {\n\terror?: string\n\tbalances: TokenBalance[] | WalletBalances\n}\n\n// ----------------------------------------------------------------------------\n// Contract API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface ValidateBytecodeResponse {\n\terror: string\n}\n\nexport interface GetRichlistResponse {\n\trichlist: RichlistEntry[]\n}\n\n// ----------------------------------------------------------------------------\n// Epoch API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface GetEmissionAddressResponse {\n\terror: 'ok'\n\temission_address: string | null\n}\n\n/**\n * Response for checking if solution is in epoch\n */\nexport interface GetSolInEpochResponse {\n\terror: 'ok' | 'invalid_epoch' | 'sol_not_found'\n}\n\n// ----------------------------------------------------------------------------\n// Peer API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface GetNodesResponse {\n\tnodes: PeerInfo[]\n}\n\nexport interface GetTrainersResponse {\n\ttrainers: PeerInfo[]\n}\n\nexport interface GetRemovedTrainersResponse {\n\tremoved_trainers: PeerInfo[]\n}\n\nexport interface GetANRsResponse {\n\tanrs: ANRInfo[]\n}\n\nexport interface GetANRByPkResponse {\n\tanr: ANRInfo\n}\n\n// ----------------------------------------------------------------------------\n// Transaction API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Query parameters for submitting a transaction\n */\nexport interface SubmitTransactionRequestQuery {\n\ttxPacked: Uint8Array\n}\n\nexport interface SubmitTransactionResponse {\n\terror: TransactionValidationError | string\n\thash?: string\n}\n\n/**\n * Response for submit and wait transaction\n */\nexport interface SubmitAndWaitTransactionResponse {\n\terror: TransactionValidationError | string\n\thash?: string\n\tmetadata?: TransactionMetadata\n\treceipt?: TransactionReceipt\n}\n\n// ----------------------------------------------------------------------------\n// Proof API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Validator proof response structure\n */\nexport interface ProofValidators {\n\tkey: string\n\tvalue: string\n\tvalidators: string[]\n\tproof: ValidatorProofData\n}\n\n/**\n * Contract state proof response structure (`/api/proof/contractstate`).\n * `value` and `result` are present only when a value is supplied for verification.\n */\nexport interface ContractStateProof {\n\tnamespace: string\n\tkey: string\n\tproof: ValidatorProofData\n\tvalue?: string\n\tresult?: boolean\n}\n\n// ----------------------------------------------------------------------------\n// Contract View Types\n// ----------------------------------------------------------------------------\n\n/**\n * Parameters for `/api/contract/view` (read-only on-chain function execution).\n */\nexport interface ContractViewParams {\n\t/** Contract name (e.g. 'Coin', 'Lockup') or Base58-encoded contract address */\n\tcontract: string\n\t/** Function name to invoke */\n\tfunction: string\n\t/** Function args (strings or raw bytes) */\n\targs?: SerializableValue[]\n\t/** Optional caller public key as 48-byte raw bytes; defaults to 48 zero bytes */\n\tpk?: Uint8Array\n}\n\n/**\n * Response from `/api/contract/view`.\n */\nexport interface ContractViewResponse {\n\tsuccess: boolean\n\tresult: string\n\tlogs: string[]\n}\n\n// ----------------------------------------------------------------------------\n// Chain KPI / Filter Types\n// ----------------------------------------------------------------------------\n\n/**\n * Protocol-level KPIs returned by `/api/chain/kpi`.\n */\nexport interface ChainKpi {\n\tama_burned: number\n\tfees_paid: number\n\tactive_validator_keys: number\n\tactive_peers: number\n\tblock_time: number\n\ttotal_tx: number\n\tuaw: number\n}\n\nexport interface GetKpiResponse {\n\tkpi: ChainKpi\n}\n\n/**\n * Filters accepted by `/api/chain/tx_by_filter`.\n * All fields are optional. `signer`/`arg0`/`cursor` are Base58-encoded strings.\n */\nexport interface TxByFilterParams {\n\t/** Base58 signer public key (also accepted as `sender` or `pk` aliases on the node) */\n\tsigner?: string\n\t/** Base58 first-arg value — typically the receiver address */\n\targ0?: string\n\t/** Contract name (ASCII) — for Base58-encoded contracts use `contract_b58` */\n\tcontract?: string\n\t/** Base58-encoded contract address (mutually exclusive with `contract`) */\n\tcontract_b58?: string\n\t/** Function name */\n\tfunction?: string\n\t/** Page size (default 100, max 1000 enforced server-side) */\n\tlimit?: number\n\t/** Sort order (default 'asc') */\n\tsort?: 'asc' | 'desc'\n\t/** Base58-encoded cursor from a previous response */\n\tcursor?: string\n}\n\nexport interface TxByFilterResponse {\n\tcursor: string | null\n\ttxs: Transaction[]\n}\n\n// ----------------------------------------------------------------------------\n// Submit-and-wait options\n// ----------------------------------------------------------------------------\n\n/**\n * Optional flags for `/api/tx/submit_and_wait`.\n */\nexport interface SubmitAndWaitOptions {\n\t/** Wait until the transaction is finalized (consensus reached) instead of just confirmed */\n\tfinalized?: boolean\n}\n"],"mappings":"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"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Type Definitions\n *\n * This module contains all TypeScript type definitions used throughout the SDK.\n */\n\n// ============================================================================\n// Core Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Serialization Types\n// ----------------------------------------------------------------------------\n\n/**\n * Serializable value types for canonical encoding (VecPack)\n */\nexport type SerializableValue =\n\t| null\n\t| boolean\n\t| number\n\t| bigint\n\t| string\n\t| Uint8Array\n\t| SerializableValue[]\n\t| Map<SerializableValue, SerializableValue>\n\t| { [key: string]: SerializableValue }\n\n/**\n * Decoded value types (Map is returned for objects during decode)\n */\nexport type DecodedValue =\n\t| null\n\t| boolean\n\t| bigint\n\t| Uint8Array\n\t| DecodedValue[]\n\t| Map<DecodedValue, DecodedValue>\n\n// ----------------------------------------------------------------------------\n// Cryptographic Types\n// ----------------------------------------------------------------------------\n\n/**\n * Key pair structure containing public and private keys as Base58 strings\n */\nexport interface KeyPair {\n\t/** Base58 encoded public key */\n\tpublicKey: string\n\t/** Base58 encoded private key (seed) */\n\tprivateKey: string\n}\n\n// ----------------------------------------------------------------------------\n// API Client Types\n// ----------------------------------------------------------------------------\n\n/**\n * SDK configuration\n */\nexport interface AmadeusSDKConfig {\n\t/** Base URL of the Amadeus node API (defaults to NODE_API_URL) */\n\tbaseUrl?: string\n\t/** Request timeout in milliseconds (default: 30000) */\n\ttimeout?: number\n\t/** Custom headers to include in requests */\n\theaders?: Record<string, string>\n}\n\n/**\n * API response wrapper\n * Note: Index signature needed for dynamic response properties\n */\nexport interface ApiResponse {\n\terror: 'ok' | 'not_found' | string\n\t[key: string]: unknown\n}\n\n/**\n * SDK error class\n */\nexport class AmadeusSDKError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status?: number,\n\t\tpublic response?: Record<string, unknown>\n\t) {\n\t\tsuper(message)\n\t\tthis.name = 'AmadeusSDKError'\n\t}\n}\n\n// ============================================================================\n// Enums\n// ============================================================================\n\n/**\n * Transaction validation error codes\n */\nexport enum TransactionValidationError {\n\tOK = 'ok',\n\tTOO_LARGE = 'too_large',\n\tTX_NOT_CANONICAL = 'tx_not_canonical',\n\tINVALID_HASH = 'invalid_hash',\n\tINVALID_SIGNATURE = 'invalid_signature',\n\tNONCE_NOT_INTEGER = 'nonce_not_integer',\n\tNONCE_TOO_HIGH = 'nonce_too_high',\n\tACTIONS_MUST_BE_LIST = 'actions_must_be_list',\n\tACTIONS_LENGTH_MUST_BE_1 = 'actions_length_must_be_1',\n\tOP_MUST_BE_CALL = 'op_must_be_call',\n\tCONTRACT_MUST_BE_BINARY = 'contract_must_be_binary',\n\tFUNCTION_MUST_BE_BINARY = 'function_must_be_binary',\n\tARGS_MUST_BE_LIST = 'args_must_be_list',\n\tARG_MUST_BE_BINARY = 'arg_must_be_binary',\n\tINVALID_MODULE = 'invalid_module',\n\tINVALID_FUNCTION = 'invalid_function',\n\tINVALID_MODULE_FOR_SPECIAL_MEETING = 'invalid_module_for_special_meeting',\n\tINVALID_FUNCTION_FOR_SPECIAL_MEETING = 'invalid_function_for_special_meeting',\n\tUNKNOWN = 'unknown'\n}\n\n/**\n * Transaction execution error codes.\n * These are returned when contract execution fails.\n */\nexport enum TransactionExecutionError {\n\t/** Success - execution completed successfully */\n\tOK = 'ok',\n\t/** Unknown error (when panic payload cannot be converted to string) */\n\tUNKNOWN = 'unknown',\n\t/** Contract execution was aborted */\n\tAS_ABORT = 'as_abort',\n\n\t// Execution budget errors\n\tEXEC_INVALID_AMOUNT_NEGATIVE = 'exec_invalid_amount_negative',\n\tEXEC_INSUFFICIENT_EXEC_BUDGET = 'exec_insufficient_exec_budget',\n\tEXEC_CRITICAL_UNDERFLOW = 'exec_critical_underflow',\n\n\t// Storage budget errors\n\tEXEC_STORAGE_INVALID_AMOUNT_NEGATIVE = 'exec_storage_invalid_amount_negative',\n\tEXEC_INSUFFICIENT_STORAGE_BUDGET = 'exec_insufficient_storage_budget',\n\tEXEC_STORAGE_CRITICAL_UNDERFLOW = 'exec_storage_critical_underflow',\n\n\t// KV operation errors\n\tEXEC_TOO_LARGE_KEY_SIZE = 'exec_too_large_key_size',\n\tEXEC_TOO_LARGE_VALUE_SIZE = 'exec_too_large_value_size',\n\tEXEC_KV_PUT_FAILED = 'exec_kv_put_failed',\n\tEXEC_KV_INCREMENT_FAILED = 'exec_kv_increment_failed',\n\tEXEC_KV_INCREMENT_INVALID_INTEGER = 'exec_kv_increment_invalid_integer',\n\tEXEC_KV_INCREMENT_INTEGER_OVERFLOW = 'exec_kv_increment_integer_overflow',\n\tKV_PUT_FAILED = 'kv_put_failed',\n\tEXEC_KV_DELETE_FAILED = 'exec_kv_delete_failed',\n\tEXEC_KV_SET_BIT_FAILED = 'exec_kv_set_bit_failed',\n\tEXEC_CANNOT_WRITE_DURING_VIEW = 'exec_cannot_write_during_view',\n\n\t// WASM execution errors\n\tEXEC_RETURN_VALUE_TOO_LARGE = 'exec_return_value_too_large',\n\tEXEC_INSTANCE_NOT_INJECTED = 'exec_instance_not_injected',\n\tEXEC_PTR_TERM_TOO_SHORT = 'exec_ptr_term_too_short',\n\tEXEC_PTR_TERM_TOO_LONG = 'exec_ptr_term_too_long',\n\tEXEC_LOG_INVALID_PTR = 'exec_log_invalid_ptr',\n\tEXEC_CALL_TABLE_INVALID_PTR = 'exec_call_table_invalid_ptr',\n\tEXEC_CALL_TOO_MANY_ARGS = 'exec_call_too_many_args',\n\tEXEC_READ_CALL_TABLE_ERROR = 'exec_read_call_table_error',\n\tEXEC_CALL_PTR_TERM_TOO_LONG = 'exec_call_ptr_term_too_long',\n\tEXEC_READ_CALL_TABLE_DATA_ERROR = 'exec_read_call_table_data_error',\n\tEXEC_CALL_EXTRA_INVALID = 'exec_call_extra_invalid',\n\tEXEC_CALL_EXTRA_TOO_MANY = 'exec_call_extra_too_many',\n\tEXEC_READ_EXTRA_ROW = 'exec_read_extra_row',\n\tEXEC_READ_EXTRA_DATA = 'exec_read_extra_data',\n\tEXEC_CALL_MISSING_ARGS = 'exec_call_missing_args',\n\tEXEC_MEMWRITE = 'exec_memwrite',\n\tEXEC_LOG_MSG_SIZE_EXCEEDED = 'exec_log_msg_size_exceeded',\n\tEXEC_LOGS_TOTAL_SIZE_EXCEEDED = 'exec_logs_total_size_exceeded',\n\tEXEC_LOGS_TOTAL_ELEMENTS_EXCEEDED = 'exec_logs_total_elements_exceeded',\n\tEXEC_INVALID_MODULE = 'exec_invalid_module',\n\tEXEC_MEMORY_ALLOC = 'exec_memory_alloc',\n\tEXEC_ARG_LEN_WRITE = 'exec_arg_len_write',\n\tEXEC_ARG_WRITE = 'exec_arg_write',\n\tEXEC_INSTANCE = 'exec_instance',\n\tEXEC_INIT_MEMWRITE = 'exec_init_memwrite',\n\tEXEC_DESERIALIZE_ERR = 'exec_deserialize_err',\n\tEXEC_SERIALIZE_ERR = 'exec_serialize_err',\n\tEXEC_FUNCTION_NOT_FOUND = 'exec_function_not_found',\n\tEXEC_ERROR = 'exec_error',\n\n\t// Contract/action errors\n\tINVALID_EPOCH = 'invalid_epoch',\n\tINVALID_BIC_ACTION = 'invalid_bic_action',\n\tINVALID_FUNCTION = 'invalid_function',\n\tACCOUNT_HAS_NO_BYTECODE = 'account_has_no_bytecode',\n\tINVALID_ATTACHED_AMOUNT = 'invalid_attached_amount',\n\tATTACHED_AMOUNT_INSUFFICIENT_FUNDS = 'attached_amount_insufficient_funds',\n\tWASM_NOOP = 'wasm_noop',\n\tINVALID_BYTECODE = 'invalid_bytecode',\n\n\t// Coin contract errors\n\tINVALID_ARGS = 'invalid_args',\n\tINVALID_AMOUNT = 'invalid_amount',\n\tINVALID_RECEIVER_PK = 'invalid_receiver_pk',\n\tINSUFFICIENT_FUNDS = 'insufficient_funds',\n\tPAUSED = 'paused',\n\tSOULBOUND = 'soulbound',\n\tINVALID_BALANCE = 'invalid_balance',\n\tINVALID_TOTAL_SUPPLY = 'invalid_total_supply',\n\tINVALID_SYMBOL = 'invalid_symbol',\n\tSYMBOL_TOO_SHORT = 'symbol_too_short',\n\tSYMBOL_TOO_LONG = 'symbol_too_long',\n\tSYMBOL_RESERVED = 'symbol_reserved',\n\tSYMBOL_EXISTS = 'symbol_exists',\n\tINVALID_DECIMALS = 'invalid_decimals',\n\tNO_PERMISSIONS = 'no_permissions',\n\tSYMBOL_DOESNT_EXIST = 'symbol_doesnt_exist',\n\tNOT_MINTABLE = 'not_mintable',\n\tINVALID_DIRECTION = 'invalid_direction',\n\tNOT_PAUSABLE = 'not_pausable',\n\n\t// Lockup contract errors\n\tINVALID_DURATION = 'invalid_duration',\n\tINVALID_VAULT = 'invalid_vault',\n\tINVALID_UNLOCK_HEIGHT = 'invalid_unlock_height',\n\tINVALID_UNLOCK_AMOUNT = 'invalid_unlock_amount',\n\tVAULT_IS_LOCKED = 'vault_is_locked',\n\n\t// Lockup Prime contract errors\n\tINVALID_TIER = 'invalid_tier',\n\tINVALID_MULTIPLIER = 'invalid_multiplier',\n\tINVALID_UNLOCK_EPOCH = 'invalid_unlock_epoch',\n\tINVALID_NEXT_CHECKIN_EPOCH = 'invalid_next_checkin_epoch',\n\n\t// NFT contract errors\n\tINSUFFICIENT_TOKENS = 'insufficient_tokens',\n\tINVALID_COLLECTION = 'invalid_collection',\n\tCOLLECTION_TOO_SHORT = 'collection_too_short',\n\tCOLLECTION_TOO_LONG = 'collection_too_long',\n\tCOLLECTION_RESERVED = 'collection_reserved',\n\tCOLLECTION_EXISTS = 'collection_exists',\n\tCOLLECTION_DOESNT_EXIST = 'collection_doesnt_exist',\n\n\t// Integer parsing errors\n\tINVALID_INTEGER = 'invalid_integer'\n}\n\n/**\n * Transaction event type\n */\nexport enum TransactionEventType {\n\tSENT = 'sent',\n\tRECEIVED = 'recv'\n}\n\n/**\n * Contract names\n */\nexport enum Contract {\n\tEPOCH = 'Epoch',\n\tCOIN = 'Coin',\n\tCONTRACT = 'Contract'\n}\n\n/**\n * Contract function names\n */\nexport enum ContractFunction {\n\tTRANSFER = 'transfer',\n\tSUBMIT_SOL = 'submit_sol',\n\tSET_EMISSION_ADDRESS = 'set_emission_address',\n\tSLASH_TRAINER = 'slash_trainer',\n\tDEPLOY = 'deploy',\n\tCREATE_AND_MINT = 'create_and_mint',\n\tMINT = 'mint',\n\tPAUSE = 'pause'\n}\n\n// ============================================================================\n// Domain Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Transaction Types\n// ----------------------------------------------------------------------------\n\n/**\n * Transaction action structure (for building transactions)\n */\nexport interface TransactionAction extends Record<string, SerializableValue> {\n\top: 'call'\n\tcontract: string\n\tfunction: string\n\targs: SerializableValue[]\n}\n\n/**\n * Transaction action structure (as returned by API)\n */\nexport interface TransactionActionResponse {\n\top: 'call'\n\tcontract: string\n\tfunction: string | ContractFunction\n\targs: (string | number | boolean)[]\n\tattached_symbol?: string\n\tattached_amount?: string\n}\n\n/**\n * Transaction action structure (legacy/alternative format)\n */\nexport interface TransactionActionBody {\n\top: 'call'\n\tcontract: string\n\tfunction: ContractFunction\n\targs: (string | Uint8Array)[]\n}\n\n/**\n * Transaction body structure\n */\nexport interface TransactionBody {\n\tsigner: Uint8Array | string\n\tnonce: number\n\taction: TransactionActionBody\n}\n\n/**\n * Unsigned transaction structure\n */\nexport interface UnsignedTransaction extends Record<string, SerializableValue> {\n\tsigner: Uint8Array\n\tnonce: bigint\n\taction: TransactionAction\n}\n\n/**\n * Unsigned transaction with its hash\n */\nexport interface UnsignedTransactionWithHash {\n\t/** Unsigned transaction structure */\n\ttx: UnsignedTransaction\n\t/** Transaction hash as Uint8Array */\n\thash: Uint8Array\n}\n\n/**\n * Packed transaction type\n */\nexport type TransactionPacked = Uint8Array\n\n/**\n * Unpacked transaction structure\n */\nexport interface TransactionUnpacked {\n\ttx: TransactionBody\n\ttx_encoded: Uint8Array\n\thash: Uint8Array\n\tsignature: Uint8Array\n\tmetadata?: {\n\t\tentry_hash: Uint8Array | string\n\t\tentry_height: number\n\t\ttx_event?: TransactionEventType\n\t}\n}\n\n/**\n * Transaction validation result\n */\nexport type TransactionValidationResult =\n\t| { error: 'ok'; txu: TransactionUnpacked }\n\t| { error: TransactionValidationError }\n\n/**\n * Result of building a transaction\n */\nexport interface BuildTransactionResult {\n\t/** Transaction hash as Base58 string */\n\ttxHash: string\n\t/** Packed transaction ready for submission */\n\ttxPacked: Uint8Array\n}\n\n/**\n * Input parameters for building a transfer transaction\n */\nexport interface TransferTransactionInput {\n\t/** Base58 encoded sender private key (seed) */\n\tsenderPrivkey: string\n\t/** Base58 encoded recipient address */\n\trecipient: string\n\t/** Amount in human-readable format */\n\tamount: number\n\t/** Token symbol (e.g., 'AMA') */\n\tsymbol: string\n}\n\nexport interface LockupPrimeLockInput {\n\tsenderPrivkey: string\n\tamount: number | string\n\ttier: string\n}\n\nexport interface LockupPrimeUnlockInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\nexport interface LockupPrimeDailyCheckinInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\nexport interface LockupUnlockInput {\n\tsenderPrivkey: string\n\tvaultIndex: number\n}\n\n/**\n * Transaction metadata (as returned by tx query endpoints).\n */\nexport interface TransactionMetadata {\n\t/** Hash of the entry containing this tx (Base58) */\n\tentry_hash: string\n\t/** Height of the entry containing this tx */\n\tentry_height: number\n\t/** Finality status — present on `chain.getTransaction` once the tx is rooted */\n\tstatus?: 'finalized' | string\n\t/** Direction — only present on `chain.getTransactionEventsByAccount` results */\n\ttx_event?: TransactionEventType\n}\n\n/**\n * Transaction receipt structure\n */\nexport interface TransactionReceipt {\n\t/** Execution result — `null` for successful txs without a return value */\n\tresult: TransactionExecutionError | string | null\n\t/** Execution logs (array of ASCII dump strings) */\n\tlogs: string[]\n\t/** Success flag */\n\tsuccess: boolean\n\t/** Execution cost used */\n\texec_used: string\n}\n\n/**\n * Transaction result (legacy field — `receipt` is preferred).\n *\n * `error` is `null` for successful txs.\n */\nexport interface TransactionResult {\n\terror: TransactionValidationError | string | null\n}\n\n/**\n * Transaction data returned from the API\n */\nexport interface Transaction {\n\t/** Transaction hash (Base58 encoded) */\n\thash: string\n\t/** Transaction signature (Base58 encoded) */\n\tsignature: string\n\t/** Transaction data */\n\ttx: {\n\t\t/** Signer's public key (Base58 encoded) */\n\t\tsigner: string\n\t\t/** Transaction nonce */\n\t\tnonce: number\n\t\t/** Transaction action */\n\t\taction: TransactionActionResponse\n\t}\n\t/** Transaction metadata */\n\tmetadata: TransactionMetadata\n\t/** Transaction result @deprecated use receipt instead */\n\tresult: TransactionResult\n\t/** Transaction receipt (execution result and logs) */\n\treceipt: TransactionReceipt\n}\n\n/**\n * Transaction event structure\n */\nexport interface TransactionEvent {\n\ttype: TransactionEventType\n\ttxid: string\n\tamount: string\n\tsymbol: string\n\ttimestamp: number\n}\n\n/**\n * Transaction filters for querying transactions\n */\nexport interface TransactionFilters {\n\tlimit?: number\n\toffset?: number\n\tsort?: 'asc' | 'desc'\n\tcursor?: string\n\tcursor_b58?: string\n\tcontract?: string | Contract\n\tcontract_b58?: string\n\tfunction?: string | ContractFunction\n\ttype?: TransactionEventType\n}\n\n// ----------------------------------------------------------------------------\n// Chain Types\n// ----------------------------------------------------------------------------\n\n/**\n * Chain entry header structure (as returned by the node).\n *\n * Source of truth: `format_entry_for_client/1` in `ex/lib/api/api_chain.ex`.\n */\nexport interface ChainEntryHeader {\n\t/** Slot number — strictly increasing, time-based */\n\tslot: number\n\t/** Block height (canonical chain position) */\n\theight: number\n\t/** Previous slot number */\n\tprev_slot: number\n\t/** Previous entry hash (Base58) */\n\tprev_hash: string\n\t/** Data-randomness (Base58) */\n\tdr: string\n\t/** VRF output (Base58) */\n\tvr: string\n\t/** Signer's public key (Base58) */\n\tsigner: string\n\t/** Root transaction hash (Base58, optional) */\n\troot_tx?: string\n\t/** Root validator (Base58, optional) */\n\troot_validator?: string\n}\n\n/**\n * Chain entry structure (as returned by the node).\n *\n * The `height` lives at `entry.header.height`, NOT at the top level.\n */\nexport interface ChainEntry {\n\t/** Header — height, slot, signer, etc. live here */\n\theader: ChainEntryHeader\n\t/** Entry hash (Base58) */\n\thash: string\n\t/** Number of transactions in this entry */\n\ttx_count: number\n\t/** Validator participation mask (Base58, optional) */\n\tmask?: string\n\t/** Number of validators reflected in `mask` */\n\tmask_size?: number\n\t/** Consensus state — present once a validator quorum is reached */\n\tconsensus?: {\n\t\t/** Fraction of validator weight that has signed (0–1) */\n\t\tscore: number\n\t\t/** True once score ≥ 0.67 (finalized) */\n\t\tfinality_reached: boolean\n\t\t/** Mutations-hash Base58 — hash of state mutations applied by this entry */\n\t\tmut_hash: string\n\t}\n\t/**\n\t * Hash of the next entry once finality has been reached on it.\n\t * Only set on `chain.getByHash` responses.\n\t */\n\tnext_entry_hash_finality_reached?: string\n\t/**\n\t * Filtered transactions — only set on `chain.getByHash` when called with\n\t * `filterOnFunction`.\n\t */\n\ttxs_filtered?: Transaction[]\n}\n\n/**\n * Chain statistics (as returned by `/api/chain/stats`).\n *\n * Source of truth: `API.Chain.stats/1` in `ex/lib/api/api_chain.ex`.\n */\nexport interface ChainStats {\n\t/** Current tip height */\n\theight: number\n\t/** Most recent finalized (rooted) height */\n\trooted_height: number\n\t/** Hash of the tip entry (Base58) */\n\ttip_hash: string\n\t/** Full tip entry */\n\ttip: ChainEntry\n\t/** Number of pending transactions in the mempool */\n\ttx_pool_size: number\n\t/** Validator scheduled to produce the current entry (Base58) */\n\tcur_validator: string\n\t/** Validator scheduled to produce the next entry (Base58) */\n\tnext_validator: string\n\t/** Emission for the current epoch (AMA float) */\n\temission_for_epoch: number\n\t/** Circulating supply (AMA float) */\n\tcirculating: number\n\t/** Total AMA burned (float) */\n\tburned: number\n\t/** Projected total supply at year 3 */\n\ttotal_supply_y3: number\n\t/** Projected total supply at year 30 */\n\ttotal_supply_y30: number\n\t/** Current difficulty bits */\n\tdiff_bits: number\n\t/** Estimated PFLOPS across the validator set */\n\tpflops: number\n\t/** Recent throughput estimate (transactions per second) */\n\ttxs_per_sec: number\n\t/** Current segment VRF hash (Base58) */\n\tsegment_vr_hash: string\n}\n\n// ----------------------------------------------------------------------------\n// Wallet Types\n// ----------------------------------------------------------------------------\n\n/**\n * Token balance structure\n */\nexport interface TokenBalance {\n\tfloat: number\n\tsymbol: string\n\tflat: number\n}\n\n/**\n * Wallet balance wrapper\n */\nexport interface WalletBalance {\n\tbalance: {\n\t\tfloat: number\n\t\tflat: number\n\t\tsymbol: string\n\t}\n}\n\n// ----------------------------------------------------------------------------\n// Contract Types\n// ----------------------------------------------------------------------------\n\n/**\n * Contract data value can be any JSON-serializable value\n */\nexport type ContractDataValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| ContractDataValue[]\n\t| { [key: string]: ContractDataValue }\n\n/**\n * Contract data structure\n */\nexport interface ContractData {\n\tcontract: string\n\tkey: string\n\tvalue: ContractDataValue\n}\n\n/**\n * Richlist entry structure (as returned by `/api/contract/richlist`).\n * Source of truth: `API.Contract.richlist/0` in `ex/lib/api/api_contract.ex`.\n */\nexport interface RichlistEntry {\n\t/** Account public key (Base58) */\n\tpk: string\n\t/** Token symbol (always 'AMA' for now) */\n\tsymbol: string\n\t/** Balance in atomic units */\n\tflat: number\n\t/** Balance in human-readable units */\n\tfloat: number\n}\n\n// ----------------------------------------------------------------------------\n// Epoch Types\n// ----------------------------------------------------------------------------\n\n/**\n * Epoch score structure.\n *\n * The all-validators variant returns a tuple array `[pk, score][]`.\n * The single-pk variant returns `{ score }` (the SDK strips the `error: 'ok'`\n * wrapper).\n */\nexport type EpochScoreAll = [string, number][]\nexport type EpochScoreSingle = { score: number }\nexport type EpochScore = EpochScoreAll | EpochScoreSingle\n\n/**\n * Emission address structure\n */\nexport interface EmissionAddress {\n\taddress: string\n\tpk: string\n}\n\n// ----------------------------------------------------------------------------\n// Peer Types\n// ----------------------------------------------------------------------------\n\n/**\n * Peer information structure\n */\nexport interface PeerInfo {\n\tpk: string\n\tversion: string\n\tlatency?: number\n\ttemporal_height?: number\n\ttemporal_hash?: string\n\trooted_height?: number\n\trooted_hash?: string\n\tis_trainer?: boolean\n\tslot_speed?: number\n\tonline?: boolean\n\tin_slot?: boolean\n}\n\n/**\n * ANR (Autonomous Network Registry) information structure\n */\nexport interface ANRInfo {\n\tpk: string\n\tpop: string\n\tsignature: string\n\tip4: string\n\tport: number\n\thandshaked: boolean\n\tisChainPop: boolean\n\tversion: string\n\tts: number\n}\n\n// ----------------------------------------------------------------------------\n// Proof Types\n// ----------------------------------------------------------------------------\n\n/**\n * Validator proof node structure\n */\nexport interface ValidatorProofNode {\n\tdirection: string\n\thash: string\n}\n\n/**\n * Validator proof data structure\n */\nexport interface ValidatorProofData {\n\troot: string\n\tpath: string\n\thash: string\n\tnodes: ValidatorProofNode[]\n}\n\n// ============================================================================\n// API Response Types\n// ============================================================================\n\n// ----------------------------------------------------------------------------\n// Chain API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface GetTipResponse {\n\tentry: ChainEntry\n}\n\nexport interface GetStatsResponse {\n\tstats: ChainStats\n}\n\nexport interface GetByHashResponse {\n\tentry: ChainEntry\n}\n\nexport interface GetByHeightResponse {\n\tentries: ChainEntry[]\n}\n\nexport interface GetTransactionEventsByAccountResponse {\n\tcursor: string\n\ttxs: TransactionEvent[]\n}\n\nexport interface GetTransactionsInEntryResponse {\n\ttxs: Transaction[]\n}\n\n// ----------------------------------------------------------------------------\n// Wallet API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Query parameters for getting token balance\n */\nexport interface GetTokenBalanceQuery {\n\taddress: string\n\tsymbol?: string\n}\n\n/**\n * Response for getting token balance\n */\nexport interface GetTokenBalanceResponse {\n\terror: string\n\tdata: TokenBalance\n}\n\n/**\n * Query parameters for getting wallet transactions\n */\nexport interface GetWalletTransactionsQuery {\n\taddress: string\n\tcontract?: Contract\n\tfunction?: ContractFunction\n\ttype?: TransactionEventType\n\tsort?: 'asc' | 'desc'\n\tlimit?: number\n\toffset?: number\n\tcursor?: string\n}\n\n/**\n * Response for getting wallet transactions\n */\nexport interface GetWalletTransactionsResponse {\n\tcursor: string\n\ttxs: Transaction[]\n}\n\n/**\n * Response from `/api/wallet/balance_all/{pk}`.\n * The node returns balances as an array of `{ float, symbol, flat }` entries.\n */\nexport interface GetAllBalancesResponse {\n\tbalances: TokenBalance[]\n}\n\n// ----------------------------------------------------------------------------\n// Contract API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Response from `/api/contract/validate`.\n *\n * Always returns the validation result and any logs emitted by the validator.\n * Note: the node currently returns `error: 'ok'` on success, which the SDK\n * strips — making `error` undefined when validation succeeds. Check `logs`\n * for diagnostic output regardless.\n */\nexport interface ValidateBytecodeResponse {\n\t/** Validation error code, if any (undefined on success after SDK strips `:ok`) */\n\terror?: string\n\t/** Validator logs (ASCII-dumped) */\n\tlogs?: string[]\n}\n\nexport interface GetRichlistResponse {\n\trichlist: RichlistEntry[]\n}\n\n// ----------------------------------------------------------------------------\n// Epoch API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Response from `/api/epoch/get_emission_address/{pk}`.\n * The `error: 'ok'` envelope is stripped by the SDK.\n */\nexport interface GetEmissionAddressResponse {\n\t/** Configured emission address (Base58), or `null` if not set */\n\temission_address: string | null\n}\n\n/**\n * Response from `/api/epoch/sol_in_epoch/{epoch}/{solHash}`.\n *\n * Empty object on success. The SDK throws `AmadeusSDKError` for\n * `invalid_epoch` / `sol_not_found` (caller can distinguish by `error.message`).\n */\nexport type GetSolInEpochResponse = Record<string, never>\n\n// ----------------------------------------------------------------------------\n// Peer API Response Types\n// ----------------------------------------------------------------------------\n\nexport interface GetNodesResponse {\n\tnodes: PeerInfo[]\n}\n\nexport interface GetTrainersResponse {\n\ttrainers: PeerInfo[]\n}\n\nexport interface GetRemovedTrainersResponse {\n\tremoved_trainers: PeerInfo[]\n}\n\nexport interface GetANRsResponse {\n\tanrs: ANRInfo[]\n}\n\nexport interface GetANRByPkResponse {\n\tanr: ANRInfo\n}\n\n// ----------------------------------------------------------------------------\n// Transaction API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Query parameters for submitting a transaction\n */\nexport interface SubmitTransactionRequestQuery {\n\ttxPacked: Uint8Array\n}\n\n/**\n * Response from `/api/tx/submit` on success.\n *\n * The SDK strips the `error: 'ok'` envelope and throws `AmadeusSDKError`\n * on validation failure — so this success type contains only the hash.\n */\nexport interface SubmitTransactionResponse {\n\t/** Submitted transaction hash (Base58) */\n\thash: string\n}\n\n/**\n * Response from `/api/tx/submit_and_wait` on success.\n *\n * The SDK strips the `error: 'ok'` envelope and throws `AmadeusSDKError`\n * on validation failure or wait timeout.\n */\nexport interface SubmitAndWaitTransactionResponse {\n\t/** Submitted transaction hash (Base58) */\n\thash: string\n\t/** Metadata about the entry containing the tx */\n\tmetadata: TransactionMetadata\n\t/** Execution receipt */\n\treceipt: TransactionReceipt\n}\n\n// ----------------------------------------------------------------------------\n// Proof API Response Types\n// ----------------------------------------------------------------------------\n\n/**\n * Validator proof response structure\n */\nexport interface ProofValidators {\n\tkey: string\n\tvalue: string\n\tvalidators: string[]\n\tproof: ValidatorProofData\n}\n\n/**\n * Contract state proof response structure (`/api/proof/contractstate`).\n * `value` and `result` are present only when a value is supplied for verification.\n */\nexport interface ContractStateProof {\n\tnamespace: string\n\tkey: string\n\tproof: ValidatorProofData\n\tvalue?: string\n\tresult?: boolean\n}\n\n// ----------------------------------------------------------------------------\n// Contract View Types\n// ----------------------------------------------------------------------------\n\n/**\n * Parameters for `/api/contract/view` (read-only on-chain function execution).\n */\nexport interface ContractViewParams {\n\t/** Contract name (e.g. 'Coin', 'Lockup') or Base58-encoded contract address */\n\tcontract: string\n\t/** Function name to invoke */\n\tfunction: string\n\t/** Function args (strings or raw bytes) */\n\targs?: SerializableValue[]\n\t/** Optional caller public key as 48-byte raw bytes; defaults to 48 zero bytes */\n\tpk?: Uint8Array\n}\n\n/**\n * Response from `/api/contract/view`.\n */\nexport interface ContractViewResponse {\n\tsuccess: boolean\n\tresult: string\n\tlogs: string[]\n}\n\n// ----------------------------------------------------------------------------\n// Chain KPI / Filter Types\n// ----------------------------------------------------------------------------\n\n/**\n * Protocol-level KPIs returned by `/api/chain/kpi`.\n */\nexport interface ChainKpi {\n\tama_burned: number\n\tfees_paid: number\n\tactive_validator_keys: number\n\tactive_peers: number\n\tblock_time: number\n\ttotal_tx: number\n\tuaw: number\n}\n\nexport interface GetKpiResponse {\n\tkpi: ChainKpi\n}\n\n/**\n * Filters accepted by `/api/chain/tx_by_filter`.\n * All fields are optional. `signer`/`arg0`/`cursor` are Base58-encoded strings.\n */\nexport interface TxByFilterParams {\n\t/** Base58 signer public key (also accepted as `sender` or `pk` aliases on the node) */\n\tsigner?: string\n\t/** Base58 first-arg value — typically the receiver address */\n\targ0?: string\n\t/** Contract name (ASCII) — for Base58-encoded contracts use `contract_b58` */\n\tcontract?: string\n\t/** Base58-encoded contract address (mutually exclusive with `contract`) */\n\tcontract_b58?: string\n\t/** Function name */\n\tfunction?: string\n\t/** Page size (default 100, max 1000 enforced server-side) */\n\tlimit?: number\n\t/** Sort order (default 'asc') */\n\tsort?: 'asc' | 'desc'\n\t/** Base58-encoded cursor from a previous response */\n\tcursor?: string\n}\n\nexport interface TxByFilterResponse {\n\tcursor: string | null\n\ttxs: Transaction[]\n}\n\n// ----------------------------------------------------------------------------\n// Submit-and-wait options\n// ----------------------------------------------------------------------------\n\n/**\n * Optional flags for `/api/tx/submit_and_wait`.\n */\nexport interface SubmitAndWaitOptions {\n\t/** Wait until the transaction is finalized (consensus reached) instead of just confirmed */\n\tfinalized?: boolean\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@amadeus-protocol/sdk",
-	"version": "1.1.0",
+	"version": "1.1.2",
 	"description": "Official TypeScript/JavaScript SDK for Amadeus Protocol - Core utilities for serialization, cryptography, transaction building, and API client",
 	"repository": {
 		"type": "git",