hearn-oracle-sdk 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# Hearn Oracle SDK
+
+This SDK provides a TypeScript interface to interact with the Hearn Oracle on the Sui blockchain, mimicking the Pyth SDK for batch price fetching.
+
+## Installation
+
+First, build the SDK:
+
+```bash
+npm install
+npm run build
+```
+
+Then, in your frontend project, you can install it locally or copy the `dist` folder.
+
+### Option 1: Local Installation (Recommended for Development)
+
+In your frontend project directory:
+
+```bash
+npm install /path/to/hearn/move/Oracle/sdk
+```
+
+Replace `/path/to/hearn/move/Oracle/sdk` with the actual path.
+
+### Option 2: Copy Files
+
+Copy the `dist` folder from this SDK to your frontend project's `node_modules/hearn-oracle-sdk/dist` or a similar location, and ensure the package.json is updated accordingly.
+
+## Usage
+
+```typescript
+import { SuiClient } from '@mysten/sui/client';
+import { OracleClient } from 'hearn-oracle-sdk';
+
+const provider = new SuiClient({ url: 'https://fullnode.mainnet.sui.io:443' });
+const packageId = '0x...'; // Replace with actual package ID from deployment
+const oracleId = '0x...'; // Replace with actual oracle object ID
+
+const client = new OracleClient(provider, packageId, oracleId);
+
+// Get price for a single asset
+const price = await client.getPriceByType('0x2::sui::SUI');
+console.log('SUI Price:', price);
+
+// Get prices for multiple assets
+const prices = await client.getPricesByTypes(['0x2::sui::SUI', '0x...::btc::BTC']);
+console.log('Prices:', prices);
+```
+
+## API Reference
+
+### OracleClient
+
+- `constructor(provider: SuiClient, packageId: string, oracleId: string)`
+- `getPriceByType(assetType: string): Promise<number>` - Get price for one asset
+- `getPricesByTypes(assetTypes: string[]): Promise<number[]>` - Get prices for multiple assets
+- `updatePrices(updateDatas: UpdateData[], clockId: string): Promise<Transaction>` - Build transaction to update prices for multiple assets
+
+### UpdateData
+
+```typescript
+interface UpdateData {
+    assetType: string;
+}
+```
+
+Prices are returned as numbers (divided by 1e18 for wad format).
+
+## Building
+
+```bash
+npm run build
+```
+
+This compiles TypeScript to JavaScript in the `dist` directory.

package/dist/example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":""}

package/dist/example.js

@@ -0,0 +1,51 @@
+"use strict";
+// Example usage of Hearn Oracle SDK
+// This file demonstrates how to use the OracleClient in a frontend application
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("@mysten/sui/client");
+const index_1 = require("./index"); // or 'hearn-oracle-sdk' if installed
+async function main() {
+    // Initialize Sui client
+    const provider = new client_1.SuiClient({
+        url: 'https://fullnode.mainnet.sui.io:443'
+    });
+    // These IDs should come from your deployment
+    const packageId = '0x...'; // Replace with actual deployed package ID
+    const oracleId = '0x...'; // Replace with actual oracle object ID
+    // Create OracleClient instance
+    const oracleClient = new index_1.OracleClient(provider, packageId, oracleId);
+    try {
+        // Example 1: Get price for SUI
+        console.log('Fetching SUI price...');
+        const suiPrice = await oracleClient.getPriceByType('0x2::sui::SUI');
+        console.log('SUI Price:', suiPrice);
+        // Example 2: Get prices for multiple assets
+        console.log('Fetching multiple prices...');
+        const assetTypes = [
+            '0x2::sui::SUI',
+            // Add more asset types as needed
+            // '0x...::btc::BTC',
+            // '0x...::eth::ETH'
+        ];
+        const prices = await oracleClient.getPricesByTypes(assetTypes);
+        console.log('Prices:', prices);
+        // Example 3: Update prices for multiple assets
+        console.log('Building transaction to update prices...');
+        const clockId = '0x6'; // Standard Clock object ID in Sui
+        const updateTx = await oracleClient.updatePrices(assetTypes, clockId);
+        console.log('Update transaction built:', updateTx);
+        // To execute the transaction, you need a signer:
+        // const signer = ...; // Your wallet signer
+        // const result = await signer.signAndExecuteTransactionBlock({
+        //     transactionBlock: updateTx,
+        // });
+        // console.log('Update result:', result);
+        // Example 4: Handle errors
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+}
+// Run the example
+main();
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":";AAAA,oCAAoC;AACpC,+EAA+E;;AAE/E,+CAA+C;AAC/C,mCAAuC,CAAC,qCAAqC;AAE7E,KAAK,UAAU,IAAI;IACf,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,kBAAS,CAAC;QAC3B,GAAG,EAAE,qCAAqC;KAC7C,CAAC,CAAC;IAEH,6CAA6C;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,0CAA0C;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,uCAAuC;IAEjE,+BAA+B;IAC/B,MAAM,YAAY,GAAG,IAAI,oBAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAErE,IAAI,CAAC;QACD,+BAA+B;QAC/B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAEpC,4CAA4C;QAC5C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG;YACf,eAAe;YACf,iCAAiC;YACjC,qBAAqB;YACrB,oBAAoB;SACvB,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE/B,+CAA+C;QAC/C,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,kCAAkC;QACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;QAEnD,iDAAiD;QACjD,4CAA4C;QAC5C,+DAA+D;QAC/D,kCAAkC;QAClC,MAAM;QACN,yCAAyC;QAEzC,2BAA2B;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;AACL,CAAC;AAED,kBAAkB;AAClB,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { SuiClient } from '@mysten/sui/client';
+import { Transaction } from '@mysten/sui/transactions';
+export declare class OracleClient {
+    private provider;
+    private packageId;
+    private oracleId;
+    constructor(provider: SuiClient, packageId: string, oracleId: string);
+    /**
+     * Get the price of a single asset by its type.
+     * @param assetType The type of the asset, e.g., '0x2::sui::SUI'
+     * @returns The price as a number (assuming wad format, divided by 1e18)
+     */
+    getPriceByType(assetType: string): Promise<number>;
+    /**
+     * Batch query feed object ids for multiple asset types in a single devInspect.
+     * Returns a map from assetType -> { priceObjectId, aggregatorId }.
+     */
+    private getFeedObjectIdsByTypes;
+    /**
+     * Get the prices of multiple assets by their types.
+     * @param assetTypes Array of asset types
+     * @returns Array of prices
+     */
+    getPricesByTypes(assetTypes: string[]): Promise<number[]>;
+    /**
+     * Update prices for multiple assets by calling adaptor_oracle::update_price in a loop.
+     * This builds a transaction that updates multiple assets' prices.
+     * @param updateDatas Array of update data for each asset
+     * @param clockId The ID of the Clock object
+     * @returns A Promise that resolves to a TransactionBlock that can be signed and executed
+     */
+    updatePrices(assetTypes: string[], clockId: string): Promise<Transaction>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAuBvD,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMpE;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BxD;;;OAGG;YACW,uBAAuB;IAiDrC;;;;OAIG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/D;;;;;;OAMG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAoBlF"}

package/dist/index.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleClient = void 0;
+const transactions_1 = require("@mysten/sui/transactions");
+const bcs_1 = require("@mysten/bcs");
+// BCS schema for `TypeName` used by the Move contract.
+// NOTE: This matches the struct shape expected on-chain.
+const TypeNameBcs = bcs_1.bcs.struct('TypeName', {
+    // Move `address` is BCS-encoded as 32 bytes in Sui.
+    addr: bcs_1.bcs.bytes(32),
+    module: bcs_1.bcs.string(),
+    name: bcs_1.bcs.string(),
+});
+function suiAddressToBytes(address) {
+    const hex = address.startsWith('0x') ? address.slice(2) : address;
+    // 32 bytes = 64 hex chars
+    const padded = hex.padStart(64, '0');
+    const buf = Buffer.from(padded, 'hex');
+    if (buf.length !== 32) {
+        throw new Error(`Invalid Sui address length: expected 32 bytes, got ${buf.length}`);
+    }
+    return new Uint8Array(buf);
+}
+class OracleClient {
+    constructor(provider, packageId, oracleId) {
+        this.provider = provider;
+        this.packageId = packageId;
+        this.oracleId = oracleId;
+    }
+    /**
+     * Get the price of a single asset by its type.
+     * @param assetType The type of the asset, e.g., '0x2::sui::SUI'
+     * @returns The price as a number (assuming wad format, divided by 1e18)
+     */
+    async getPriceByType(assetType) {
+        const tx = new transactions_1.Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::oracle::price_by_type`,
+            typeArguments: [assetType],
+            arguments: [tx.object(this.oracleId)],
+        });
+        const result = await this.provider.devInspectTransactionBlock({
+            transactionBlock: tx,
+            sender: '0x0000000000000000000000000000000000000000000000000000000000000000', // dummy sender for read-only
+        });
+        if (!result.results || result.results.length === 0) {
+            throw new Error('No results from transaction inspection');
+        }
+        const returnValue = result.results[0].returnValues?.[0];
+        if (!returnValue) {
+            throw new Error('No return value from price_by_type');
+        }
+        // Assuming return is u128 as bytes, convert to bigint
+        const priceBigInt = BigInt('0x' + Buffer.from(returnValue[0]).toString('hex'));
+        // Assuming wad format, divide by 1e18
+        return Number(priceBigInt) / 1e18;
+    }
+    /**
+     * Batch query feed object ids for multiple asset types in a single devInspect.
+     * Returns a map from assetType -> { priceObjectId, aggregatorId }.
+     */
+    async getFeedObjectIdsByTypes(assetTypes) {
+        const queryTx = new transactions_1.Transaction();
+        const typeNames = assetTypes.map((assetType) => {
+            const [address, module, name] = assetType.split('::');
+            return { addr: suiAddressToBytes(address), module, name };
+        });
+        queryTx.moveCall({
+            target: `${this.packageId}::pyth_oracle::get_feed_object_addresses_batch`,
+            arguments: [queryTx.object(this.oracleId), queryTx.pure(bcs_1.bcs.vector(TypeNameBcs).serialize(typeNames))],
+        });
+        const queryResult = await this.provider.devInspectTransactionBlock({
+            transactionBlock: queryTx,
+            sender: '0x0000000000000000000000000000000000000000000000000000000000000000',
+        });
+        if (!queryResult.results || queryResult.results.length !== 1) {
+            throw new Error(`Unexpected results length from get_feed_object_addresses_batch: ${queryResult.results?.length ?? 0}`);
+        }
+        const returnValues = queryResult.results[0]?.returnValues;
+        if (!returnValues || returnValues.length < 2) {
+            throw new Error('Invalid return values from get_feed_object_addresses_batch');
+        }
+        // Each return is a BCS-encoded `vector<address>`.
+        const pythAddrBytesVec = bcs_1.bcs.vector(bcs_1.bcs.bytes(32)).parse(new Uint8Array(returnValues[0][0]));
+        const sbAddrBytesVec = bcs_1.bcs.vector(bcs_1.bcs.bytes(32)).parse(new Uint8Array(returnValues[1][0]));
+        if (pythAddrBytesVec.length !== assetTypes.length || sbAddrBytesVec.length !== assetTypes.length) {
+            throw new Error(`Unexpected address vector lengths from get_feed_object_addresses_batch: pyth=${pythAddrBytesVec.length}, sb=${sbAddrBytesVec.length}, expected=${assetTypes.length}`);
+        }
+        const out = {};
+        for (let i = 0; i < assetTypes.length; i++) {
+            const assetType = assetTypes[i];
+            out[assetType] = {
+                priceObjectId: '0x' + Buffer.from(pythAddrBytesVec[i]).toString('hex'),
+                aggregatorId: '0x' + Buffer.from(sbAddrBytesVec[i]).toString('hex'),
+            };
+        }
+        return out;
+    }
+    /**
+     * Get the prices of multiple assets by their types.
+     * @param assetTypes Array of asset types
+     * @returns Array of prices
+     */
+    async getPricesByTypes(assetTypes) {
+        const promises = assetTypes.map(assetType => this.getPriceByType(assetType));
+        return Promise.all(promises);
+    }
+    /**
+     * Update prices for multiple assets by calling adaptor_oracle::update_price in a loop.
+     * This builds a transaction that updates multiple assets' prices.
+     * @param updateDatas Array of update data for each asset
+     * @param clockId The ID of the Clock object
+     * @returns A Promise that resolves to a TransactionBlock that can be signed and executed
+     */
+    async updatePrices(assetTypes, clockId) {
+        const tx = new transactions_1.Transaction();
+        // 1) Batch query feed object ids (single devInspect).
+        const feedObjectIdsByType = await this.getFeedObjectIdsByTypes(assetTypes);
+        // 2) Add update calls using the queried ids.
+        // NOTE: caller guarantees `assetTypes` has no duplicates and order does not matter.
+        for (const [assetType, ids] of Object.entries(feedObjectIdsByType)) {
+            tx.moveCall({
+                target: `${this.packageId}::adaptor_oracle::update_price`,
+                typeArguments: [assetType],
+                arguments: [
+                    tx.object(this.oracleId),
+                    tx.object(ids.priceObjectId),
+                    tx.object(ids.aggregatorId),
+                    tx.object(clockId),
+                ],
+            });
+        }
+        return tx;
+    }
+}
+exports.OracleClient = OracleClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "hearn-oracle-sdk",
+  "version": "1.0.0",
+  "description": "SDK for interacting with Hearn Oracle on Sui blockchain",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@mysten/sui": "^1.45.2",
+    "@mysten/bcs": "^1.9.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  }
+}

package/src/example.ts

@@ -0,0 +1,57 @@
+// Example usage of Hearn Oracle SDK
+// This file demonstrates how to use the OracleClient in a frontend application
+
+import { SuiClient } from '@mysten/sui/client';
+import { OracleClient } from './index'; // or 'hearn-oracle-sdk' if installed
+
+async function main() {
+    // Initialize Sui client
+    const provider = new SuiClient({
+        url: 'https://fullnode.mainnet.sui.io:443'
+    });
+
+    // These IDs should come from your deployment
+    const packageId = '0x...'; // Replace with actual deployed package ID
+    const oracleId = '0x...'; // Replace with actual oracle object ID
+
+    // Create OracleClient instance
+    const oracleClient = new OracleClient(provider, packageId, oracleId);
+
+    try {
+        // Example 1: Get price for SUI
+        console.log('Fetching SUI price...');
+        const suiPrice = await oracleClient.getPriceByType('0x2::sui::SUI');
+        console.log('SUI Price:', suiPrice);
+
+        // Example 2: Get prices for multiple assets
+        console.log('Fetching multiple prices...');
+        const assetTypes = [
+            '0x2::sui::SUI',
+            // Add more asset types as needed
+            // '0x...::btc::BTC',
+            // '0x...::eth::ETH'
+        ];
+        const prices = await oracleClient.getPricesByTypes(assetTypes);
+        console.log('Prices:', prices);
+
+        // Example 3: Update prices for multiple assets
+        console.log('Building transaction to update prices...');
+        const clockId = '0x6'; // Standard Clock object ID in Sui
+        const updateTx = await oracleClient.updatePrices(assetTypes, clockId);
+        console.log('Update transaction built:', updateTx);
+
+        // To execute the transaction, you need a signer:
+        // const signer = ...; // Your wallet signer
+        // const result = await signer.signAndExecuteTransactionBlock({
+        //     transactionBlock: updateTx,
+        // });
+        // console.log('Update result:', result);
+
+        // Example 4: Handle errors
+    } catch (error) {
+        console.error('Error:', error);
+    }
+}
+
+// Run the example
+main();

package/src/index.ts

@@ -0,0 +1,159 @@
+import { SuiClient } from '@mysten/sui/client';
+import { Transaction } from '@mysten/sui/transactions';
+import { bcs } from '@mysten/bcs';
+
+// BCS schema for `TypeName` used by the Move contract.
+// NOTE: This matches the struct shape expected on-chain.
+const TypeNameBcs = bcs.struct('TypeName', {
+    // Move `address` is BCS-encoded as 32 bytes in Sui.
+    addr: bcs.bytes(32),
+    module: bcs.string(),
+    name: bcs.string(),
+});
+
+function suiAddressToBytes(address: string): Uint8Array {
+    const hex = address.startsWith('0x') ? address.slice(2) : address;
+    // 32 bytes = 64 hex chars
+    const padded = hex.padStart(64, '0');
+    const buf = Buffer.from(padded, 'hex');
+    if (buf.length !== 32) {
+        throw new Error(`Invalid Sui address length: expected 32 bytes, got ${buf.length}`);
+    }
+    return new Uint8Array(buf);
+}
+
+export class OracleClient {
+    private provider: SuiClient;
+    private packageId: string;
+    private oracleId: string;
+
+    constructor(provider: SuiClient, packageId: string, oracleId: string) {
+        this.provider = provider;
+        this.packageId = packageId;
+        this.oracleId = oracleId;
+    }
+
+    /**
+     * Get the price of a single asset by its type.
+     * @param assetType The type of the asset, e.g., '0x2::sui::SUI'
+     * @returns The price as a number (assuming wad format, divided by 1e18)
+     */
+    async getPriceByType(assetType: string): Promise<number> {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::oracle::price_by_type`,
+            typeArguments: [assetType],
+            arguments: [tx.object(this.oracleId)],
+        });
+
+        const result = await this.provider.devInspectTransactionBlock({
+            transactionBlock: tx,
+            sender: '0x0000000000000000000000000000000000000000000000000000000000000000', // dummy sender for read-only
+        });
+
+        if (!result.results || result.results.length === 0) {
+            throw new Error('No results from transaction inspection');
+        }
+
+        const returnValue = result.results[0].returnValues?.[0];
+        if (!returnValue) {
+            throw new Error('No return value from price_by_type');
+        }
+
+        // Assuming return is u128 as bytes, convert to bigint
+        const priceBigInt = BigInt('0x' + Buffer.from(returnValue[0]).toString('hex'));
+        // Assuming wad format, divide by 1e18
+        return Number(priceBigInt) / 1e18;
+    }
+
+    /**
+     * Batch query feed object ids for multiple asset types in a single devInspect.
+     * Returns a map from assetType -> { priceObjectId, aggregatorId }.
+     */
+    private async getFeedObjectIdsByTypes(
+        assetTypes: string[],
+    ): Promise<Record<string, { priceObjectId: string; aggregatorId: string }>> {
+        const queryTx = new Transaction();
+        const typeNames = assetTypes.map((assetType) => {
+            const [address, module, name] = assetType.split('::');
+            return { addr: suiAddressToBytes(address), module, name };
+        });
+
+        queryTx.moveCall({
+            target: `${this.packageId}::pyth_oracle::get_feed_object_addresses_batch`,
+            arguments: [queryTx.object(this.oracleId), queryTx.pure(bcs.vector(TypeNameBcs).serialize(typeNames))],
+        });
+
+        const queryResult = await this.provider.devInspectTransactionBlock({
+            transactionBlock: queryTx,
+            sender: '0x0000000000000000000000000000000000000000000000000000000000000000',
+        });
+
+        if (!queryResult.results || queryResult.results.length !== 1) {
+            throw new Error(`Unexpected results length from get_feed_object_addresses_batch: ${queryResult.results?.length ?? 0}`);
+        }
+
+        const returnValues = queryResult.results[0]?.returnValues;
+        if (!returnValues || returnValues.length < 2) {
+            throw new Error('Invalid return values from get_feed_object_addresses_batch');
+        }
+
+        // Each return is a BCS-encoded `vector<address>`.
+        const pythAddrBytesVec = bcs.vector(bcs.bytes(32)).parse(new Uint8Array(returnValues[0]![0] as any));
+        const sbAddrBytesVec = bcs.vector(bcs.bytes(32)).parse(new Uint8Array(returnValues[1]![0] as any));
+
+        if (pythAddrBytesVec.length !== assetTypes.length || sbAddrBytesVec.length !== assetTypes.length) {
+            throw new Error(
+                `Unexpected address vector lengths from get_feed_object_addresses_batch: pyth=${pythAddrBytesVec.length}, sb=${sbAddrBytesVec.length}, expected=${assetTypes.length}`,
+            );
+        }
+
+        const out: Record<string, { priceObjectId: string; aggregatorId: string }> = {};
+        for (let i = 0; i < assetTypes.length; i++) {
+            const assetType = assetTypes[i]!;
+            out[assetType] = {
+                priceObjectId: '0x' + Buffer.from(pythAddrBytesVec[i]!).toString('hex'),
+                aggregatorId: '0x' + Buffer.from(sbAddrBytesVec[i]!).toString('hex'),
+            };
+        }
+        return out;
+    }
+
+    /**
+     * Get the prices of multiple assets by their types.
+     * @param assetTypes Array of asset types
+     * @returns Array of prices
+     */
+    async getPricesByTypes(assetTypes: string[]): Promise<number[]> {
+        const promises = assetTypes.map(assetType => this.getPriceByType(assetType));
+        return Promise.all(promises);
+    }
+
+    /**
+     * Update prices for multiple assets by calling adaptor_oracle::update_price in a loop.
+     * This builds a transaction that updates multiple assets' prices.
+     * @param updateDatas Array of update data for each asset
+     * @param clockId The ID of the Clock object
+     * @returns A Promise that resolves to a TransactionBlock that can be signed and executed
+     */
+    async updatePrices(assetTypes: string[], clockId: string): Promise<Transaction> {
+        const tx = new Transaction();
+        // 1) Batch query feed object ids (single devInspect).
+        const feedObjectIdsByType = await this.getFeedObjectIdsByTypes(assetTypes);
+        // 2) Add update calls using the queried ids.
+        // NOTE: caller guarantees `assetTypes` has no duplicates and order does not matter.
+        for (const [assetType, ids] of Object.entries(feedObjectIdsByType)) {
+            tx.moveCall({
+                target: `${this.packageId}::adaptor_oracle::update_price`,
+                typeArguments: [assetType],
+                arguments: [
+                    tx.object(this.oracleId),
+                    tx.object(ids.priceObjectId),
+                    tx.object(ids.aggregatorId),
+                    tx.object(clockId),
+                ],
+            });
+        }
+        return tx;
+    }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}