@amadeus-protocol/sdk 1.0.8 → 1.1.1

package/dist/api/chain.js

@@ -1,147 +1,176 @@
-/**
- * Chain API
- *
- * Provides methods for querying blockchain data
- */
-import { Base58HashSchema, TransactionFiltersSchema } from '../schemas';
-import { Schema } from 'effect';
-import { validate } from '../validation';
-export class ChainAPI {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Get the current chain tip (latest entry)
-     *
-     * @returns Promise resolving to the latest chain entry
-     *
-     * @example
-     * ```ts
-     * const { entry } = await sdk.chain.getTip()
-     * console.log('Current height:', entry.height)
-     * ```
-     */
-    async getTip() {
-        return this.client.get('/api/chain/tip');
-    }
-    /**
-     * Get chain statistics
-     *
-     * @returns Promise resolving to chain statistics
-     *
-     * @example
-     * ```ts
-     * const { stats } = await sdk.chain.getStats()
-     * console.log('Total entries:', stats.total_entries)
-     * ```
-     */
-    async getStats() {
-        return this.client.get('/api/chain/stats');
-    }
-    /**
-     * Get entry by hash
-     *
-     * @param hash - Entry hash (Base58 encoded)
-     * @param filterOnFunction - Optional function filter
-     * @returns Promise resolving to chain entry
-     * @throws {Error} If hash is invalid
-     *
-     * @example
-     * ```ts
-     * const { entry } = await sdk.chain.getByHash('5Kd3N...')
-     * ```
-     */
-    async getByHash(hash, filterOnFunction) {
-        validate(Base58HashSchema, hash);
-        return this.client.get(`/api/chain/hash/${hash}`, {
-            filter_on_function: filterOnFunction
-        });
-    }
-    /**
-     * Get entries by height
-     *
-     * @param height - Block height (must be >= 0)
-     * @returns Promise resolving to chain entries at the specified height
-     * @throws {Error} If height is invalid
-     *
-     * @example
-     * ```ts
-     * const { entries } = await sdk.chain.getByHeight(1000)
-     * ```
-     */
-    async getByHeight(height) {
-        validate(Schema.NonNegativeInt, height);
-        return this.client.get(`/api/chain/height/${height}`);
-    }
-    /**
-     * Get entries by height with transactions
-     *
-     * @param height - Block height (must be >= 0)
-     * @returns Promise resolving to chain entries with transactions at the specified height
-     * @throws {Error} If height is invalid
-     *
-     * @example
-     * ```ts
-     * const { entries } = await sdk.chain.getByHeightWithTxs(1000)
-     * ```
-     */
-    async getByHeightWithTxs(height) {
-        validate(Schema.NonNegativeInt, height);
-        return this.client.get(`/api/chain/height_with_txs/${height}`);
-    }
-    /**
-     * Get a specific transaction by ID
-     *
-     * @param txid - Transaction ID (Base58 encoded)
-     * @returns Promise resolving to transaction data
-     * @throws {Error} If transaction ID is invalid
-     *
-     * @example
-     * ```ts
-     * const tx = await sdk.chain.getTransaction('5Kd3N...')
-     * ```
-     */
-    async getTransaction(txid) {
-        validate(Base58HashSchema, txid);
-        return this.client.get(`/api/chain/tx/${txid}`);
-    }
-    /**
-     * Get transactions in a specific entry
-     *
-     * @param entryHash - Entry hash (Base58 encoded)
-     * @returns Promise resolving to transactions in the entry
-     * @throws {Error} If entry hash is invalid
-     *
-     * @example
-     * ```ts
-     * const { txs } = await sdk.chain.getTransactionsInEntry('5Kd3N...')
-     * ```
-     */
-    async getTransactionsInEntry(entryHash) {
-        validate(Base58HashSchema, entryHash);
-        return this.client.get(`/api/chain/txs_in_entry/${entryHash}`);
-    }
-    /**
-     * Get transaction events by account with filtering
-     *
-     * @param account - Account address (Base58 encoded)
-     * @param filters - Optional filters for transactions
-     * @returns Promise resolving to transaction events
-     * @throws {Error} If account address is invalid
-     *
-     * @example
-     * ```ts
-     * const { txs, cursor } = await sdk.chain.getTransactionEventsByAccount('5Kd3N...', {
-     *   limit: 10,
-     *   sort: 'desc'
-     * })
-     * ```
-     */
-    async getTransactionEventsByAccount(account, filters = {}) {
-        validate(Base58HashSchema, account);
-        validate(TransactionFiltersSchema, filters);
-        return this.client.get(`/api/chain/tx_events_by_account/${account}`, filters);
-    }
-}
+import { validate } from "../validation.js";
+import { Base58HashSchema, TransactionFiltersSchema } from "../schemas.js";
+import { Schema } from "effect";
+//#region src/api/chain.ts
+var ChainAPI = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	/**
+	* Get the current chain tip (latest entry)
+	*
+	* @returns Promise resolving to the latest chain entry
+	*
+	* @example
+	* ```ts
+	* const { entry } = await sdk.chain.getTip()
+	* console.log('Current height:', entry.height)
+	* ```
+	*/
+	async getTip() {
+		return this.client.get("/api/chain/tip");
+	}
+	/**
+	* Get chain statistics
+	*
+	* @returns Promise resolving to chain statistics
+	*
+	* @example
+	* ```ts
+	* const { stats } = await sdk.chain.getStats()
+	* console.log('Total entries:', stats.total_entries)
+	* ```
+	*/
+	async getStats() {
+		return this.client.get("/api/chain/stats");
+	}
+	/**
+	* Get entry by hash
+	*
+	* @param hash - Entry hash (Base58 encoded)
+	* @param filterOnFunction - Optional function filter
+	* @returns Promise resolving to chain entry
+	* @throws {Error} If hash is invalid
+	*
+	* @example
+	* ```ts
+	* const { entry } = await sdk.chain.getByHash('5Kd3N...')
+	* ```
+	*/
+	async getByHash(hash, filterOnFunction) {
+		validate(Base58HashSchema, hash);
+		return this.client.get(`/api/chain/hash/${hash}`, { filter_on_function: filterOnFunction });
+	}
+	/**
+	* Get entries by height
+	*
+	* @param height - Block height (must be >= 0)
+	* @returns Promise resolving to chain entries at the specified height
+	* @throws {Error} If height is invalid
+	*
+	* @example
+	* ```ts
+	* const { entries } = await sdk.chain.getByHeight(1000)
+	* ```
+	*/
+	async getByHeight(height) {
+		validate(Schema.NonNegativeInt, height);
+		return this.client.get(`/api/chain/height/${height}`);
+	}
+	/**
+	* Get entries by height with transactions
+	*
+	* @param height - Block height (must be >= 0)
+	* @returns Promise resolving to chain entries with transactions at the specified height
+	* @throws {Error} If height is invalid
+	*
+	* @example
+	* ```ts
+	* const { entries } = await sdk.chain.getByHeightWithTxs(1000)
+	* ```
+	*/
+	async getByHeightWithTxs(height) {
+		validate(Schema.NonNegativeInt, height);
+		return this.client.get(`/api/chain/height_with_txs/${height}`);
+	}
+	/**
+	* Get a specific transaction by ID
+	*
+	* @param txid - Transaction ID (Base58 encoded)
+	* @returns Promise resolving to transaction data
+	* @throws {Error} If transaction ID is invalid
+	*
+	* @example
+	* ```ts
+	* const tx = await sdk.chain.getTransaction('5Kd3N...')
+	* ```
+	*/
+	async getTransaction(txid) {
+		validate(Base58HashSchema, txid);
+		return this.client.get(`/api/chain/tx/${txid}`);
+	}
+	/**
+	* Get transactions in a specific entry
+	*
+	* @param entryHash - Entry hash (Base58 encoded)
+	* @returns Promise resolving to transactions in the entry
+	* @throws {Error} If entry hash is invalid
+	*
+	* @example
+	* ```ts
+	* const { txs } = await sdk.chain.getTransactionsInEntry('5Kd3N...')
+	* ```
+	*/
+	async getTransactionsInEntry(entryHash) {
+		validate(Base58HashSchema, entryHash);
+		return this.client.get(`/api/chain/txs_in_entry/${entryHash}`);
+	}
+	/**
+	* Get transaction events by account with filtering
+	*
+	* @param account - Account address (Base58 encoded)
+	* @param filters - Optional filters for transactions
+	* @returns Promise resolving to transaction events
+	* @throws {Error} If account address is invalid
+	*
+	* @example
+	* ```ts
+	* const { txs, cursor } = await sdk.chain.getTransactionEventsByAccount('5Kd3N...', {
+	*   limit: 10,
+	*   sort: 'desc'
+	* })
+	* ```
+	*/
+	async getTransactionEventsByAccount(account, filters = {}) {
+		validate(Base58HashSchema, account);
+		validate(TransactionFiltersSchema, filters);
+		return this.client.get(`/api/chain/tx_events_by_account/${account}`, filters);
+	}
+	/**
+	* Query transactions by arbitrary filter (signer, receiver, contract, function).
+	*
+	* All filter fields are optional; provide only the ones you want to constrain.
+	* Returns a cursor for pagination — pass it back as `cursor` in a subsequent call.
+	*
+	* @example
+	* ```ts
+	* const { txs, cursor } = await sdk.chain.getByFilter({
+	*   signer: '5Kd3N...',
+	*   contract: 'Coin',
+	*   function: 'transfer',
+	*   limit: 50,
+	*   sort: 'desc'
+	* })
+	* ```
+	*/
+	async getByFilter(filters = {}) {
+		return this.client.get("/api/chain/tx_by_filter", filters);
+	}
+	/**
+	* Get protocol-level KPIs (burned, fees, active validators/peers, total tx, UAW, etc.).
+	*
+	* @example
+	* ```ts
+	* const { kpi } = await sdk.chain.getKpi()
+	* console.log('Total tx:', kpi.total_tx)
+	* ```
+	*/
+	async getKpi() {
+		return this.client.get("/api/chain/kpi");
+	}
+};
+//#endregion
+export { ChainAPI };
+
 //# sourceMappingURL=chain.js.map

package/dist/api/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/api/chain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,OAAO,QAAQ;IACA;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAiB,gBAAgB,CAAC,CAAA;IACzD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAmB,kBAAkB,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,gBAAyB;QACtD,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,mBAAmB,IAAI,EAAE,EAAE;YACpE,kBAAkB,EAAE,gBAAgB;SACpC,CAAC,CAAA;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,WAAW,CAAC,MAAc;QAC/B,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsB,qBAAqB,MAAM,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAc;QACtC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsB,8BAA8B,MAAM,EAAE,CAAC,CAAA;IACpF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY;QAChC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAc,iBAAiB,IAAI,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,sBAAsB,CAAC,SAAiB;QAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACrB,2BAA2B,SAAS,EAAE,CACtC,CAAA;IACF,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,6BAA6B,CAClC,OAAe,EACf,UAA8B,EAAE;QAEhC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAA;QAE3C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACrB,mCAAmC,OAAO,EAAE,EAC5C,OAAkC,CAClC,CAAA;IACF,CAAC;CACD"}
+{"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"}

package/dist/api/contract.d.ts

@@ -1,62 +1,80 @@
-/**
- * Contract API
- *
- * Provides methods for interacting with smart contracts
- */
-import type { AmadeusClient } from '../client';
-import type { ValidateBytecodeResponse, GetRichlistResponse, ContractDataValue } from '../types';
-export declare class ContractAPI {
-    private client;
-    constructor(client: AmadeusClient);
-    /**
-     * Validate contract bytecode
-     *
-     * @param bytecode - Contract bytecode as Uint8Array or ArrayBuffer
-     * @returns Promise resolving to validation result
-     * @throws {AmadeusSDKError} If bytecode is invalid or empty
-     *
-     * @example
-     * ```ts
-     * const result = await sdk.contract.validateBytecode(wasmBytecode)
-     * ```
-     */
-    validateBytecode(bytecode: Uint8Array | ArrayBuffer): Promise<ValidateBytecodeResponse>;
-    /**
-     * Get contract data by key
-     *
-     * @param key - Contract key as Uint8Array or Base58 string
-     * @returns Promise resolving to contract data value (JSON-serializable)
-     * @throws {AmadeusSDKError} If key is invalid
-     *
-     * @example
-     * ```ts
-     * const data = await sdk.contract.get(keyBytes)
-     * ```
-     */
-    get(key: Uint8Array | string): Promise<ContractDataValue>;
-    /**
-     * Get contract data by key prefix
-     *
-     * @param key - Contract key prefix as Uint8Array or Base58 string
-     * @returns Promise resolving to contract data matching the prefix (array of key-value pairs)
-     * @throws {AmadeusSDKError} If key is invalid
-     *
-     * @example
-     * ```ts
-     * const data = await sdk.contract.getPrefix(keyPrefix)
-     * ```
-     */
-    getPrefix(key: Uint8Array | string): Promise<ContractDataValue[]>;
-    /**
-     * Get contract richlist (token holders)
-     *
-     * @returns Promise resolving to richlist entries
-     *
-     * @example
-     * ```ts
-     * const { richlist } = await sdk.contract.getRichlist()
-     * ```
-     */
-    getRichlist(): Promise<GetRichlistResponse>;
+import { ContractDataValue, ContractViewParams, ContractViewResponse, GetRichlistResponse, ValidateBytecodeResponse } from "../types.js";
+import { AmadeusClient } from "../client.js";
+
+//#region src/api/contract.d.ts
+declare class ContractAPI {
+  private client;
+  constructor(client: AmadeusClient);
+  /**
+   * Validate contract bytecode
+   *
+   * @param bytecode - Contract bytecode as Uint8Array or ArrayBuffer
+   * @returns Promise resolving to validation result
+   * @throws {AmadeusSDKError} If bytecode is invalid or empty
+   *
+   * @example
+   * ```ts
+   * const result = await sdk.contract.validateBytecode(wasmBytecode)
+   * ```
+   */
+  validateBytecode(bytecode: Uint8Array | ArrayBuffer): Promise<ValidateBytecodeResponse>;
+  /**
+   * Get contract data by key
+   *
+   * @param key - Contract key as Uint8Array or Base58 string
+   * @returns Promise resolving to contract data value (JSON-serializable)
+   * @throws {AmadeusSDKError} If key is invalid
+   *
+   * @example
+   * ```ts
+   * const data = await sdk.contract.get(keyBytes)
+   * ```
+   */
+  get(key: Uint8Array | string): Promise<ContractDataValue>;
+  /**
+   * Get contract data by key prefix
+   *
+   * @param key - Contract key prefix as Uint8Array or Base58 string
+   * @returns Promise resolving to contract data matching the prefix (array of key-value pairs)
+   * @throws {AmadeusSDKError} If key is invalid
+   *
+   * @example
+   * ```ts
+   * const data = await sdk.contract.getPrefix(keyPrefix)
+   * ```
+   */
+  getPrefix(key: Uint8Array | string): Promise<ContractDataValue[]>;
+  /**
+   * Get contract richlist (token holders)
+   *
+   * @returns Promise resolving to richlist entries
+   *
+   * @example
+   * ```ts
+   * const { richlist } = await sdk.contract.getRichlist()
+   * ```
+   */
+  getRichlist(): Promise<GetRichlistResponse>;
+  /**
+   * Execute a contract function in read-only (view) mode against the current chain tip.
+   *
+   * No transaction is created and no state is mutated. Useful for querying contract
+   * state through the contract's own logic (e.g. computed balances, vault status).
+   *
+   * @param params - Contract, function, args, and optional caller pk
+   * @returns Promise resolving to `{ success, result, logs }`
+   *
+   * @example
+   * ```ts
+   * const { success, result } = await sdk.contract.view({
+   *   contract: 'LockupPrime',
+   *   function: 'view_balance',
+   *   args: ['my_vault']
+   * })
+   * ```
+   */
+  view(params: ContractViewParams): Promise<ContractViewResponse>;
 }
+//#endregion
+export { ContractAPI };
 //# sourceMappingURL=contract.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/api/contract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAIhG,qBAAa,WAAW;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAM7F;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK/D;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKvE;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAGjD"}
+{"version":3,"file":"contract.d.ts","names":[],"sources":["../../src/api/contract.ts"],"mappings":";;;;cAmBa,WAAA;EAAA,QACQ,MAAA;cAAA,MAAA,EAAQ,aAAA;EAcwC;;;;;;;;;;;;EAA9D,gBAAA,CAAiB,QAAA,EAAU,UAAA,GAAa,WAAA,GAAc,OAAA,CAAQ,wBAAA;EAwErB;;;;;;;;;;;;EAtDzC,GAAA,CAAI,GAAA,EAAK,UAAA,YAAsB,OAAA,CAAQ,iBAAA;EAA9B;;;;;;;;;;;;EAiBT,SAAA,CAAU,GAAA,EAAK,UAAA,YAAsB,OAAA,CAAQ,iBAAA;EAqChC;;;;;;;;;;EAtBb,WAAA,CAAA,GAAe,OAAA,CAAQ,mBAAA;;;;;;;;;;;;;;;;;;;EAsBvB,IAAA,CAAK,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,oBAAA;AAAA"}