@amadeus-protocol/sdk 1.0.8 → 1.1.1

package/dist/api/contract.js

@@ -1,76 +1,103 @@
-/**
- * Contract API
- *
- * Provides methods for interacting with smart contracts
- */
-import { BytecodeSchema, ContractKeySchema } from '../schemas';
-import { validate } from '../validation';
-export class ContractAPI {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * 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)
-     * ```
-     */
-    async validateBytecode(bytecode) {
-        validate(BytecodeSchema, bytecode);
-        const body = bytecode instanceof ArrayBuffer ? new Uint8Array(bytecode) : bytecode;
-        return this.client.post('/api/contract/validate_bytecode', body);
-    }
-    /**
-     * 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)
-     * ```
-     */
-    async get(key) {
-        validate(ContractKeySchema, key);
-        return this.client.post('/api/contract/get', key);
-    }
-    /**
-     * 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)
-     * ```
-     */
-    async getPrefix(key) {
-        validate(ContractKeySchema, key);
-        return this.client.post('/api/contract/get_prefix', key);
-    }
-    /**
-     * Get contract richlist (token holders)
-     *
-     * @returns Promise resolving to richlist entries
-     *
-     * @example
-     * ```ts
-     * const { richlist } = await sdk.contract.getRichlist()
-     * ```
-     */
-    async getRichlist() {
-        return this.client.get('/api/contract/richlist');
-    }
-}
+import { encode } from "../serialization.js";
+import { validate } from "../validation.js";
+import { BytecodeSchema, ContractKeySchema } from "../schemas.js";
+//#region src/api/contract.ts
+var ContractAPI = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	/**
+	* 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)
+	* ```
+	*/
+	async validateBytecode(bytecode) {
+		validate(BytecodeSchema, bytecode);
+		const body = bytecode instanceof ArrayBuffer ? new Uint8Array(bytecode) : bytecode;
+		return this.client.post("/api/contract/validate_bytecode", body);
+	}
+	/**
+	* 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)
+	* ```
+	*/
+	async get(key) {
+		validate(ContractKeySchema, key);
+		return this.client.post("/api/contract/get", key);
+	}
+	/**
+	* 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)
+	* ```
+	*/
+	async getPrefix(key) {
+		validate(ContractKeySchema, key);
+		return this.client.post("/api/contract/get_prefix", key);
+	}
+	/**
+	* Get contract richlist (token holders)
+	*
+	* @returns Promise resolving to richlist entries
+	*
+	* @example
+	* ```ts
+	* const { richlist } = await sdk.contract.getRichlist()
+	* ```
+	*/
+	async getRichlist() {
+		return this.client.get("/api/contract/richlist");
+	}
+	/**
+	* 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']
+	* })
+	* ```
+	*/
+	async view(params) {
+		const body = {
+			contract: params.contract,
+			function: params.function,
+			args: params.args ?? []
+		};
+		if (params.pk) body.pk = params.pk;
+		return this.client.post("/api/contract/view", encode(body));
+	}
+};
+//#endregion
+export { ContractAPI };
+
 //# sourceMappingURL=contract.js.map

package/dist/api/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/api/contract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,OAAO,WAAW;IACH;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAkC;QACxD,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;QAClC,MAAM,IAAI,GAAG,QAAQ,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QAClF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAA2B,iCAAiC,EAAE,IAAI,CAAC,CAAA;IAC3F,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,GAAwB;QACjC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAoB,mBAAmB,EAAE,GAAG,CAAC,CAAA;IACrE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,CAAC,GAAwB;QACvC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAsB,0BAA0B,EAAE,GAAG,CAAC,CAAA;IAC9E,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsB,wBAAwB,CAAC,CAAA;IACtE,CAAC;CACD"}
+{"version":3,"file":"contract.js","names":[],"sources":["../../src/api/contract.ts"],"sourcesContent":["/**\n * Contract API\n *\n * Provides methods for interacting with smart contracts\n */\n\nimport type { AmadeusClient } from '../client'\nimport type {\n\tValidateBytecodeResponse,\n\tGetRichlistResponse,\n\tContractDataValue,\n\tContractViewParams,\n\tContractViewResponse,\n\tSerializableValue\n} from '../types'\nimport { BytecodeSchema, ContractKeySchema } from '../schemas'\nimport { validate } from '../validation'\nimport { encode } from '../serialization'\n\nexport class ContractAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Validate contract bytecode\n\t *\n\t * @param bytecode - Contract bytecode as Uint8Array or ArrayBuffer\n\t * @returns Promise resolving to validation result\n\t * @throws {AmadeusSDKError} If bytecode is invalid or empty\n\t *\n\t * @example\n\t * ```ts\n\t * const result = await sdk.contract.validateBytecode(wasmBytecode)\n\t * ```\n\t */\n\tasync validateBytecode(bytecode: Uint8Array | ArrayBuffer): Promise<ValidateBytecodeResponse> {\n\t\tvalidate(BytecodeSchema, bytecode)\n\t\tconst body = bytecode instanceof ArrayBuffer ? new Uint8Array(bytecode) : bytecode\n\t\treturn this.client.post<ValidateBytecodeResponse>('/api/contract/validate_bytecode', body)\n\t}\n\n\t/**\n\t * Get contract data by key\n\t *\n\t * @param key - Contract key as Uint8Array or Base58 string\n\t * @returns Promise resolving to contract data value (JSON-serializable)\n\t * @throws {AmadeusSDKError} If key is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const data = await sdk.contract.get(keyBytes)\n\t * ```\n\t */\n\tasync get(key: Uint8Array | string): Promise<ContractDataValue> {\n\t\tvalidate(ContractKeySchema, key)\n\t\treturn this.client.post<ContractDataValue>('/api/contract/get', key)\n\t}\n\n\t/**\n\t * Get contract data by key prefix\n\t *\n\t * @param key - Contract key prefix as Uint8Array or Base58 string\n\t * @returns Promise resolving to contract data matching the prefix (array of key-value pairs)\n\t * @throws {AmadeusSDKError} If key is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const data = await sdk.contract.getPrefix(keyPrefix)\n\t * ```\n\t */\n\tasync getPrefix(key: Uint8Array | string): Promise<ContractDataValue[]> {\n\t\tvalidate(ContractKeySchema, key)\n\t\treturn this.client.post<ContractDataValue[]>('/api/contract/get_prefix', key)\n\t}\n\n\t/**\n\t * Get contract richlist (token holders)\n\t *\n\t * @returns Promise resolving to richlist entries\n\t *\n\t * @example\n\t * ```ts\n\t * const { richlist } = await sdk.contract.getRichlist()\n\t * ```\n\t */\n\tasync getRichlist(): Promise<GetRichlistResponse> {\n\t\treturn this.client.get<GetRichlistResponse>('/api/contract/richlist')\n\t}\n\n\t/**\n\t * Execute a contract function in read-only (view) mode against the current chain tip.\n\t *\n\t * No transaction is created and no state is mutated. Useful for querying contract\n\t * state through the contract's own logic (e.g. computed balances, vault status).\n\t *\n\t * @param params - Contract, function, args, and optional caller pk\n\t * @returns Promise resolving to `{ success, result, logs }`\n\t *\n\t * @example\n\t * ```ts\n\t * const { success, result } = await sdk.contract.view({\n\t *   contract: 'LockupPrime',\n\t *   function: 'view_balance',\n\t *   args: ['my_vault']\n\t * })\n\t * ```\n\t */\n\tasync view(params: ContractViewParams): Promise<ContractViewResponse> {\n\t\tconst body: Record<string, SerializableValue> = {\n\t\t\tcontract: params.contract,\n\t\t\tfunction: params.function,\n\t\t\targs: params.args ?? []\n\t\t}\n\t\tif (params.pk) body.pk = params.pk\n\t\treturn this.client.post<ContractViewResponse>('/api/contract/view', encode(body))\n\t}\n}\n"],"mappings":";;;;AAmBA,IAAa,cAAb,MAAyB;CACJ;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;;CAcpB,MAAM,iBAAiB,UAAuE;EAC7F,SAAS,gBAAgB,SAAS;EAClC,MAAM,OAAO,oBAAoB,cAAc,IAAI,WAAW,SAAS,GAAG;EAC1E,OAAO,KAAK,OAAO,KAA+B,mCAAmC,KAAK;;;;;;;;;;;;;;CAe3F,MAAM,IAAI,KAAsD;EAC/D,SAAS,mBAAmB,IAAI;EAChC,OAAO,KAAK,OAAO,KAAwB,qBAAqB,IAAI;;;;;;;;;;;;;;CAerE,MAAM,UAAU,KAAwD;EACvE,SAAS,mBAAmB,IAAI;EAChC,OAAO,KAAK,OAAO,KAA0B,4BAA4B,IAAI;;;;;;;;;;;;CAa9E,MAAM,cAA4C;EACjD,OAAO,KAAK,OAAO,IAAyB,yBAAyB;;;;;;;;;;;;;;;;;;;;CAqBtE,MAAM,KAAK,QAA2D;EACrE,MAAM,OAA0C;GAC/C,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB,MAAM,OAAO,QAAQ,EAAE;GACvB;EACD,IAAI,OAAO,IAAI,KAAK,KAAK,OAAO;EAChC,OAAO,KAAK,OAAO,KAA2B,sBAAsB,OAAO,KAAK,CAAC"}

package/dist/api/epoch.d.ts

@@ -1,68 +1,67 @@
-/**
- * Epoch API
- *
- * Provides methods for querying epoch and validator information
- */
-import type { AmadeusClient } from '../client';
-import type { EpochScore, GetEmissionAddressResponse, GetSolInEpochResponse } from '../types';
-export declare class EpochAPI {
-    private client;
-    constructor(client: AmadeusClient);
-    /**
-     * Get epoch score for all validators or a specific validator
-     *
-     * @param publicKey - Optional validator public key (Base58 encoded)
-     * @returns Promise resolving to epoch score(s)
-     * @throws {Error} If public key is invalid
-     *
-     * @example
-     * ```ts
-     * // Get all scores
-     * const scores = await sdk.epoch.getScore()
-     *
-     * // Get specific validator score
-     * const score = await sdk.epoch.getScore('5Kd3N...')
-     * ```
-     */
-    getScore(publicKey?: string): Promise<EpochScore>;
-    /**
-     * Get emission address for a public key
-     *
-     * @param publicKey - Validator public key (Base58 encoded)
-     * @returns Promise resolving to emission address
-     * @throws {Error} If public key is invalid
-     *
-     * @example
-     * ```ts
-     * const { emission_address } = await sdk.epoch.getEmissionAddress('5Kd3N...')
-     * ```
-     */
-    getEmissionAddress(publicKey: string): Promise<GetEmissionAddressResponse>;
-    /**
-     * Get solution in epoch
-     *
-     * @param epoch - Epoch number (must be >= 0)
-     * @param solHash - Solution hash as string or Uint8Array
-     * @returns Promise resolving to solution data
-     * @throws {Error} If parameters are invalid
-     *
-     * @example
-     * ```ts
-     * const sol = await sdk.epoch.getSolInEpoch(100, '5Kd3N...')
-     * ```
-     */
-    getSolInEpoch(epoch: number, solHash: string | Uint8Array): Promise<GetSolInEpochResponse>;
-    /**
-     * Get all epoch scores as array of [pk, score] tuples
-     */
-    getAllScores(): Promise<[string, number][]>;
-    /**
-     * Get epoch score for a specific validator
-     */
-    getValidatorScore(publicKey: string): Promise<number>;
-    /**
-     * Get top validators by score
-     */
-    getTopValidators(limit?: number): Promise<[string, number][]>;
+import { EpochScore, GetEmissionAddressResponse, GetSolInEpochResponse } from "../types.js";
+import { AmadeusClient } from "../client.js";
+
+//#region src/api/epoch.d.ts
+declare class EpochAPI {
+  private client;
+  constructor(client: AmadeusClient);
+  /**
+   * Get epoch score for all validators or a specific validator
+   *
+   * @param publicKey - Optional validator public key (Base58 encoded)
+   * @returns Promise resolving to epoch score(s)
+   * @throws {Error} If public key is invalid
+   *
+   * @example
+   * ```ts
+   * // Get all scores
+   * const scores = await sdk.epoch.getScore()
+   *
+   * // Get specific validator score
+   * const score = await sdk.epoch.getScore('5Kd3N...')
+   * ```
+   */
+  getScore(publicKey?: string): Promise<EpochScore>;
+  /**
+   * Get emission address for a public key
+   *
+   * @param publicKey - Validator public key (Base58 encoded)
+   * @returns Promise resolving to emission address
+   * @throws {Error} If public key is invalid
+   *
+   * @example
+   * ```ts
+   * const { emission_address } = await sdk.epoch.getEmissionAddress('5Kd3N...')
+   * ```
+   */
+  getEmissionAddress(publicKey: string): Promise<GetEmissionAddressResponse>;
+  /**
+   * Get solution in epoch
+   *
+   * @param epoch - Epoch number (must be >= 0)
+   * @param solHash - Solution hash as string or Uint8Array
+   * @returns Promise resolving to solution data
+   * @throws {Error} If parameters are invalid
+   *
+   * @example
+   * ```ts
+   * const sol = await sdk.epoch.getSolInEpoch(100, '5Kd3N...')
+   * ```
+   */
+  getSolInEpoch(epoch: number, solHash: string | Uint8Array): Promise<GetSolInEpochResponse>;
+  /**
+   * Get all epoch scores as array of [pk, score] tuples
+   */
+  getAllScores(): Promise<[string, number][]>;
+  /**
+   * Get epoch score for a specific validator
+   */
+  getValidatorScore(publicKey: string): Promise<number>;
+  /**
+   * Get top validators by score
+   */
+  getTopValidators(limit?: number): Promise<[string, number][]>;
 }
+//#endregion
+export { EpochAPI };
 //# sourceMappingURL=epoch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"epoch.d.ts","sourceRoot":"","sources":["../../src/api/epoch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAK7F,qBAAa,QAAQ;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQvD;;;;;;;;;;;OAWG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAOhF;;;;;;;;;;;;OAYG;IACG,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,UAAU,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAKjD;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3D;;OAEG;IACG,gBAAgB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAIvE"}
+{"version":3,"file":"epoch.d.ts","names":[],"sources":["../../src/api/epoch.ts"],"mappings":";;;;cAYa,QAAA;EAAA,QACQ,MAAA;cAAA,MAAA,EAAQ,aAAA;EAsCyB;;;;;;;;;;;;;;;;EApB/C,QAAA,CAAS,SAAA,YAAqB,OAAA,CAAQ,UAAA;EAAA;;;;;;;;;;;;EAoBtC,kBAAA,CAAmB,SAAA,WAAoB,OAAA,CAAQ,0BAAA;EA6C/C;;;;;;;;;;;;;EAzBA,aAAA,CACL,KAAA,UACA,OAAA,WAAkB,UAAA,GAChB,OAAA,CAAQ,qBAAA;;;;EAcL,YAAA,CAAA,GAAgB,OAAA;;;;EAQhB,iBAAA,CAAkB,SAAA,WAAoB,OAAA;;;;EAWtC,gBAAA,CAAiB,KAAA,YAAqB,OAAA;AAAA"}

package/dist/api/epoch.js

@@ -1,99 +1,91 @@
-/**
- * Epoch API
- *
- * Provides methods for querying epoch and validator information
- */
-import { Base58PublicKeySchema } from '../schemas';
-import { Schema } from 'effect';
-import { validate } from '../validation';
-export class EpochAPI {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Get epoch score for all validators or a specific validator
-     *
-     * @param publicKey - Optional validator public key (Base58 encoded)
-     * @returns Promise resolving to epoch score(s)
-     * @throws {Error} If public key is invalid
-     *
-     * @example
-     * ```ts
-     * // Get all scores
-     * const scores = await sdk.epoch.getScore()
-     *
-     * // Get specific validator score
-     * const score = await sdk.epoch.getScore('5Kd3N...')
-     * ```
-     */
-    async getScore(publicKey) {
-        if (publicKey) {
-            validate(Base58PublicKeySchema, publicKey);
-        }
-        const url = publicKey ? `/api/epoch/score/${publicKey}` : '/api/epoch/score';
-        return this.client.get(url);
-    }
-    /**
-     * Get emission address for a public key
-     *
-     * @param publicKey - Validator public key (Base58 encoded)
-     * @returns Promise resolving to emission address
-     * @throws {Error} If public key is invalid
-     *
-     * @example
-     * ```ts
-     * const { emission_address } = await sdk.epoch.getEmissionAddress('5Kd3N...')
-     * ```
-     */
-    async getEmissionAddress(publicKey) {
-        validate(Base58PublicKeySchema, publicKey);
-        return this.client.get(`/api/epoch/get_emission_address/${publicKey}`);
-    }
-    /**
-     * Get solution in epoch
-     *
-     * @param epoch - Epoch number (must be >= 0)
-     * @param solHash - Solution hash as string or Uint8Array
-     * @returns Promise resolving to solution data
-     * @throws {Error} If parameters are invalid
-     *
-     * @example
-     * ```ts
-     * const sol = await sdk.epoch.getSolInEpoch(100, '5Kd3N...')
-     * ```
-     */
-    async getSolInEpoch(epoch, solHash) {
-        validate(Schema.NonNegativeInt, epoch);
-        if (!solHash) {
-            throw new Error('Solution hash is required');
-        }
-        const hash = typeof solHash === 'string' ? solHash : solHash.toString();
-        return this.client.get(`/api/epoch/sol_in_epoch/${epoch}/${hash}`);
-    }
-    /**
-     * Get all epoch scores as array of [pk, score] tuples
-     */
-    async getAllScores() {
-        const result = await this.getScore();
-        return Array.isArray(result) ? result : [];
-    }
-    /**
-     * Get epoch score for a specific validator
-     */
-    async getValidatorScore(publicKey) {
-        const result = await this.getScore(publicKey);
-        if (Array.isArray(result)) {
-            throw new Error('Unexpected array response for single validator score');
-        }
-        return result.score;
-    }
-    /**
-     * Get top validators by score
-     */
-    async getTopValidators(limit = 10) {
-        const scores = await this.getAllScores();
-        return scores.sort((a, b) => b[1] - a[1]).slice(0, limit);
-    }
-}
+import { validate } from "../validation.js";
+import { Base58PublicKeySchema } from "../schemas.js";
+import { Schema } from "effect";
+//#region src/api/epoch.ts
+var EpochAPI = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	/**
+	* Get epoch score for all validators or a specific validator
+	*
+	* @param publicKey - Optional validator public key (Base58 encoded)
+	* @returns Promise resolving to epoch score(s)
+	* @throws {Error} If public key is invalid
+	*
+	* @example
+	* ```ts
+	* // Get all scores
+	* const scores = await sdk.epoch.getScore()
+	*
+	* // Get specific validator score
+	* const score = await sdk.epoch.getScore('5Kd3N...')
+	* ```
+	*/
+	async getScore(publicKey) {
+		if (publicKey) validate(Base58PublicKeySchema, publicKey);
+		const url = publicKey ? `/api/epoch/score/${publicKey}` : "/api/epoch/score";
+		return this.client.get(url);
+	}
+	/**
+	* Get emission address for a public key
+	*
+	* @param publicKey - Validator public key (Base58 encoded)
+	* @returns Promise resolving to emission address
+	* @throws {Error} If public key is invalid
+	*
+	* @example
+	* ```ts
+	* const { emission_address } = await sdk.epoch.getEmissionAddress('5Kd3N...')
+	* ```
+	*/
+	async getEmissionAddress(publicKey) {
+		validate(Base58PublicKeySchema, publicKey);
+		return this.client.get(`/api/epoch/get_emission_address/${publicKey}`);
+	}
+	/**
+	* Get solution in epoch
+	*
+	* @param epoch - Epoch number (must be >= 0)
+	* @param solHash - Solution hash as string or Uint8Array
+	* @returns Promise resolving to solution data
+	* @throws {Error} If parameters are invalid
+	*
+	* @example
+	* ```ts
+	* const sol = await sdk.epoch.getSolInEpoch(100, '5Kd3N...')
+	* ```
+	*/
+	async getSolInEpoch(epoch, solHash) {
+		validate(Schema.NonNegativeInt, epoch);
+		if (!solHash) throw new Error("Solution hash is required");
+		const hash = typeof solHash === "string" ? solHash : solHash.toString();
+		return this.client.get(`/api/epoch/sol_in_epoch/${epoch}/${hash}`);
+	}
+	/**
+	* Get all epoch scores as array of [pk, score] tuples
+	*/
+	async getAllScores() {
+		const result = await this.getScore();
+		return Array.isArray(result) ? result : [];
+	}
+	/**
+	* Get epoch score for a specific validator
+	*/
+	async getValidatorScore(publicKey) {
+		const result = await this.getScore(publicKey);
+		if (Array.isArray(result)) throw new Error("Unexpected array response for single validator score");
+		return result.score;
+	}
+	/**
+	* Get top validators by score
+	*/
+	async getTopValidators(limit = 10) {
+		return (await this.getAllScores()).sort((a, b) => b[1] - a[1]).slice(0, limit);
+	}
+};
+//#endregion
+export { EpochAPI };
+
 //# sourceMappingURL=epoch.js.map

package/dist/api/epoch.js.map

@@ -1 +1 @@
-{"version":3,"file":"epoch.js","sourceRoot":"","sources":["../../src/api/epoch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,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;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAkB;QAChC,IAAI,SAAS,EAAE,CAAC;YACf,QAAQ,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAA;QAC3C,CAAC;QACD,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAA;QAC5E,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAa,GAAG,CAAC,CAAA;IACxC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,kBAAkB,CAAC,SAAiB;QACzC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CACrB,mCAAmC,SAAS,EAAE,CAC9C,CAAA;IACF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,aAAa,CAClB,KAAa,EACb,OAA4B;QAE5B,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAwB,2BAA2B,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;IAC1F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QACjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QACpC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACxE,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAC1D,CAAC;CACD"}
+{"version":3,"file":"epoch.js","names":[],"sources":["../../src/api/epoch.ts"],"sourcesContent":["/**\n * Epoch API\n *\n * Provides methods for querying epoch and validator information\n */\n\nimport type { AmadeusClient } from '../client'\nimport type { EpochScore, GetEmissionAddressResponse, GetSolInEpochResponse } from '../types'\nimport { Base58PublicKeySchema } from '../schemas'\nimport { Schema } from 'effect'\nimport { validate } from '../validation'\n\nexport class EpochAPI {\n\tconstructor(private client: AmadeusClient) {}\n\n\t/**\n\t * Get epoch score for all validators or a specific validator\n\t *\n\t * @param publicKey - Optional validator public key (Base58 encoded)\n\t * @returns Promise resolving to epoch score(s)\n\t * @throws {Error} If public key is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * // Get all scores\n\t * const scores = await sdk.epoch.getScore()\n\t *\n\t * // Get specific validator score\n\t * const score = await sdk.epoch.getScore('5Kd3N...')\n\t * ```\n\t */\n\tasync getScore(publicKey?: string): Promise<EpochScore> {\n\t\tif (publicKey) {\n\t\t\tvalidate(Base58PublicKeySchema, publicKey)\n\t\t}\n\t\tconst url = publicKey ? `/api/epoch/score/${publicKey}` : '/api/epoch/score'\n\t\treturn this.client.get<EpochScore>(url)\n\t}\n\n\t/**\n\t * Get emission address for a public key\n\t *\n\t * @param publicKey - Validator public key (Base58 encoded)\n\t * @returns Promise resolving to emission address\n\t * @throws {Error} If public key is invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const { emission_address } = await sdk.epoch.getEmissionAddress('5Kd3N...')\n\t * ```\n\t */\n\tasync getEmissionAddress(publicKey: string): Promise<GetEmissionAddressResponse> {\n\t\tvalidate(Base58PublicKeySchema, publicKey)\n\t\treturn this.client.get<GetEmissionAddressResponse>(\n\t\t\t`/api/epoch/get_emission_address/${publicKey}`\n\t\t)\n\t}\n\n\t/**\n\t * Get solution in epoch\n\t *\n\t * @param epoch - Epoch number (must be >= 0)\n\t * @param solHash - Solution hash as string or Uint8Array\n\t * @returns Promise resolving to solution data\n\t * @throws {Error} If parameters are invalid\n\t *\n\t * @example\n\t * ```ts\n\t * const sol = await sdk.epoch.getSolInEpoch(100, '5Kd3N...')\n\t * ```\n\t */\n\tasync getSolInEpoch(\n\t\tepoch: number,\n\t\tsolHash: string | Uint8Array\n\t): Promise<GetSolInEpochResponse> {\n\t\tvalidate(Schema.NonNegativeInt, epoch)\n\n\t\tif (!solHash) {\n\t\t\tthrow new Error('Solution hash is required')\n\t\t}\n\n\t\tconst hash = typeof solHash === 'string' ? solHash : solHash.toString()\n\t\treturn this.client.get<GetSolInEpochResponse>(`/api/epoch/sol_in_epoch/${epoch}/${hash}`)\n\t}\n\n\t/**\n\t * Get all epoch scores as array of [pk, score] tuples\n\t */\n\tasync getAllScores(): Promise<[string, number][]> {\n\t\tconst result = await this.getScore()\n\t\treturn Array.isArray(result) ? result : []\n\t}\n\n\t/**\n\t * Get epoch score for a specific validator\n\t */\n\tasync getValidatorScore(publicKey: string): Promise<number> {\n\t\tconst result = await this.getScore(publicKey)\n\t\tif (Array.isArray(result)) {\n\t\t\tthrow new Error('Unexpected array response for single validator score')\n\t\t}\n\t\treturn result.score\n\t}\n\n\t/**\n\t * Get top validators by score\n\t */\n\tasync getTopValidators(limit: number = 10): Promise<[string, number][]> {\n\t\tconst scores = await this.getAllScores()\n\t\treturn scores.sort((a, b) => b[1] - a[1]).slice(0, limit)\n\t}\n}\n"],"mappings":";;;;AAYA,IAAa,WAAb,MAAsB;CACD;CAApB,YAAY,QAA+B;EAAvB,KAAA,SAAA;;;;;;;;;;;;;;;;;;CAkBpB,MAAM,SAAS,WAAyC;EACvD,IAAI,WACH,SAAS,uBAAuB,UAAU;EAE3C,MAAM,MAAM,YAAY,oBAAoB,cAAc;EAC1D,OAAO,KAAK,OAAO,IAAgB,IAAI;;;;;;;;;;;;;;CAexC,MAAM,mBAAmB,WAAwD;EAChF,SAAS,uBAAuB,UAAU;EAC1C,OAAO,KAAK,OAAO,IAClB,mCAAmC,YACnC;;;;;;;;;;;;;;;CAgBF,MAAM,cACL,OACA,SACiC;EACjC,SAAS,OAAO,gBAAgB,MAAM;EAEtC,IAAI,CAAC,SACJ,MAAM,IAAI,MAAM,4BAA4B;EAG7C,MAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ,UAAU;EACvE,OAAO,KAAK,OAAO,IAA2B,2BAA2B,MAAM,GAAG,OAAO;;;;;CAM1F,MAAM,eAA4C;EACjD,MAAM,SAAS,MAAM,KAAK,UAAU;EACpC,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,EAAE;;;;;CAM3C,MAAM,kBAAkB,WAAoC;EAC3D,MAAM,SAAS,MAAM,KAAK,SAAS,UAAU;EAC7C,IAAI,MAAM,QAAQ,OAAO,EACxB,MAAM,IAAI,MAAM,uDAAuD;EAExE,OAAO,OAAO;;;;;CAMf,MAAM,iBAAiB,QAAgB,IAAiC;EAEvE,QAAO,MADc,KAAK,cAAc,EAC1B,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM"}