@n1xyz/nord-ts 0.3.2 → 0.3.4

package/dist/nord/client/NordAdmin.d.ts

@@ -0,0 +1,226 @@
+import { PublicKey } from "@solana/web3.js";
+import * as proto from "../../gen/nord_pb";
+import { Nord } from "./Nord";
+import { FeeTierConfig } from "../../gen/nord_pb";
+export declare enum AclRole {
+    FEE_MANAGER = 1,
+    MARKET_MANAGER = 2,
+    ADMIN = -2147483648
+}
+/**
+ * Administrative client capable of submitting privileged configuration actions.
+ */
+export declare class NordAdmin {
+    private readonly nord;
+    private readonly admin;
+    private readonly signFn;
+    private constructor();
+    /** Create a new admin client.
+     *
+     * @param nord - Nord instance
+     * @param admin - The user that will be signing actions.
+     * @param signFn - Function to sign messages with the admin's wallet.
+     *
+     * `signFn` must sign the _hex-encoded_ message, not the raw message itself, for
+     * the purpose of being compatible with Solana wallets.
+     *
+     * In practice, you will do something along the lines of:
+     *
+     * ```typescript
+     * (x) => wallet.signMessage(new TextEncoder().encode(x.toHex()));
+     * ```
+     *
+     * For a software signing key, this might look more like:
+     *
+     * ```typescript
+     * (x) => nacl.sign.detached(new TextEncoder().encode(x.toHex()), sk);
+     * ``
+     *
+     * where `nacl` is the tweetnacl library.
+     */
+    static new({ nord, admin, signFn, }: Readonly<{
+        nord: Nord;
+        admin: PublicKey;
+        signFn: (m: Uint8Array) => Promise<Uint8Array>;
+    }>): NordAdmin;
+    /**
+     * Submit an action and append the admin signature before sending it to Nord.
+     *
+     * @param kind - Action payload describing the admin request
+     * @throws {NordError} If signing or submission fails
+     */
+    private submitAction;
+    /** Set acl permissions for a given user.
+     *
+     * If all roles are removed, the user is removed from the acl.
+     *
+     * @param target - User to update.
+     * @param addRoles - Roles to add to the user.
+     * @param removeRoles - Reles to remove from the user.
+     */
+    updateAcl({ target, addRoles, removeRoles, }: Readonly<{
+        target: PublicKey;
+        addRoles: AclRole[];
+        removeRoles: AclRole[];
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_AclUpdated>;
+    /**
+     * Register a new token that can be listed on Nord.
+     *
+     * @param mintAddr - SPL mint to register
+     * @param tokenDecimals - On-chain decimal precision
+     * @param weightBps - Risk weight in basis points
+     * @param viewSymbol - Symbol shown to users
+     * @param oracleSymbol - Symbol used by the oracle
+     * @returns Action identifier and resulting token metadata
+     * @throws {NordError} If the action submission fails
+     */
+    createToken({ mintAddr, tokenDecimals, weightBps, viewSymbol, oracleSymbol, }: Readonly<Omit<proto.Action_CreateToken, "aclPubkey" | "solAddr">> & {
+        mintAddr: PublicKey;
+    }): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_InsertTokenResult>;
+    /**
+     * Open a new market with explicit trading parameters.
+     *
+     * @param sizeDecimals - Base asset decimal precision
+     * @param priceDecimals - Quote price decimal precision
+     * @param imfBps - Initial margin fraction in basis points
+     * @param cmfBps - Cancel margin fraction in basis points
+     * @param mmfBps - Maintenance margin fraction in basis points
+     * @param marketType - Market kind to open
+     * @param viewSymbol - Symbol shown to users
+     * @param oracleSymbol - Symbol used by the oracle
+     * @param baseTokenId - Token id used as the base asset
+     * @returns Action identifier and resulting market metadata
+     * @throws {NordError} If the action submission fails
+     */
+    createMarket({ sizeDecimals, priceDecimals, imfBps, cmfBps, mmfBps, marketType, viewSymbol, oracleSymbol, baseTokenId, }: Readonly<Omit<proto.Action_CreateMarket, "aclPubkey">>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_InsertMarketResult>;
+    /**
+     * Update the Pyth guardian set used for verifying Wormhole messages.
+     *
+     * Each address must decode from a 20-byte hex string (with or without a
+     * leading `0x` prefix). The engine validates the supplied guardian set index
+     * before applying the update.
+     *
+     * @param guardianSetIndex - Wormhole guardian set identifier
+     * @param guardianAddresses - Guardian addresses as 20-byte hex strings
+     * @returns Action identifier and guardian update receipt
+     * @throws {NordError} If the action submission fails
+     */
+    pythSetWormholeGuardians({ guardianSetIndex, addresses: guardianAddresses, }: Readonly<{
+        guardianSetIndex: number;
+        addresses: string[];
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_UpdateGuardianSetResult>;
+    /**
+     * Link an oracle symbol to a specific Pyth price feed.
+     *
+     * The price feed identifier must decode to 32 bytes (with or without a
+     * leading `0x` prefix). Use this call to create or update the mapping used
+     * by the oracle integration.
+     *
+     * @param oracleSymbol - Symbol to update
+     * @param priceFeedHex - 32-byte hex price feed id
+     * @returns Action identifier and symbol feed receipt
+     * @throws {NordError} If the action submission fails
+     */
+    pythSetSymbolFeed({ oracleSymbol, priceFeedId: priceFeedHex, }: Readonly<{
+        oracleSymbol: string;
+        priceFeedId: string;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_OracleSymbolFeedResult>;
+    /**
+     * Pause all trading activity on the exchange.
+     *
+     * @returns Action identifier confirming the pause
+     * @throws {NordError} If the action submission fails
+     */
+    pause(): Promise<{
+        actionId: bigint;
+    }>;
+    /**
+     * Resume trading activity after a pause.
+     *
+     * @returns Action identifier confirming the unpause
+     * @throws {NordError} If the action submission fails
+     */
+    unpause(): Promise<{
+        actionId: bigint;
+    }>;
+    /**
+     * Freeze an individual market, preventing new trades and orders.
+     *
+     * @param marketId - Target market identifier
+     * @returns Action identifier and freeze receipt
+     * @throws {NordError} If the action submission fails
+     */
+    freezeMarket({ marketId, }: Readonly<{
+        marketId: number;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_MarketFreezeUpdated>;
+    /**
+     * Unfreeze a market that was previously halted.
+     *
+     * @param marketId - Target market identifier
+     * @returns Action identifier and freeze receipt
+     * @throws {NordError} If the action submission fails
+     */
+    unfreezeMarket({ marketId, }: Readonly<{
+        marketId: number;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_MarketFreezeUpdated>;
+    /**
+     * Append a new fee tier to the account bracket configuration.
+     *
+     * - The engine supports at most 16 tiers (ids 0–15). Tier 0 is reserved for
+     *   the default Nord fees; use `updateFeeTier` if you need to change it.
+     * - The first appended tier receives id 1, and subsequent tiers increment the id.
+     *
+     * @param config - Maker/taker configuration to insert
+     * @returns Action identifier and fee tier addition receipt
+     * @throws {NordError} If the action submission fails or the new tier exceeds the maximum range (0-15).
+     */
+    addFeeTier(config: Readonly<FeeTierConfig>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_FeeTierAdded>;
+    /**
+     * Update an existing fee tier with new maker/taker rates.
+     *
+     * Tier identifiers must already exist; attempting to update a missing tier
+     * causes the action to fail.
+     *
+     * @param tierId - Fee tier identifier
+     * @param config - Updated maker/taker configuration
+     * @returns Action identifier and fee tier update receipt
+     * @throws {NordError} If the action submission fails or the tier ID exceeds the configured range.
+     */
+    updateFeeTier({ tierId, config, }: Readonly<{
+        tierId: number;
+        config: FeeTierConfig;
+    }>): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_FeeTierUpdated>;
+    /**
+     * Assign a fee tier to one or more accounts.
+     *
+     * The tier id must be within the configured range (0–15). Every account starts
+     * on tier 0; assigning it to another tier requires that tier to exist already.
+     * Invalid account ids or tier ids cause the action to fail.
+     *
+     * @param accounts - Account IDs to update
+     * @param tierId - Target fee tier identifier
+     * @returns Action identifier and accounts-tier receipt
+     * @throws {NordError} If the tier id exceeds the configured range or an account id is invalid.
+     */
+    updateAccountsTier(accounts: number[], tierId: number): Promise<{
+        actionId: bigint;
+    } & proto.Receipt_AccountsTierUpdated>;
+}

package/dist/nord/client/NordAdmin.js

@@ -0,0 +1,410 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NordAdmin = exports.AclRole = void 0;
+const protobuf_1 = require("@bufbuild/protobuf");
+const proto = __importStar(require("../../gen/nord_pb"));
+const utils_1 = require("../../utils");
+const actions_1 = require("../api/actions");
+const NordError_1 = require("../utils/NordError");
+// NOTE: keep in sync with `acl.rs`.
+// NOTE: don't forget `number` as int is internally a u32.
+var AclRole;
+(function (AclRole) {
+    AclRole[AclRole["FEE_MANAGER"] = 1] = "FEE_MANAGER";
+    AclRole[AclRole["MARKET_MANAGER"] = 2] = "MARKET_MANAGER";
+    // TODO: unsure about this?
+    AclRole[AclRole["ADMIN"] = -2147483648] = "ADMIN";
+})(AclRole || (exports.AclRole = AclRole = {}));
+/**
+ * Administrative client capable of submitting privileged configuration actions.
+ */
+class NordAdmin {
+    constructor({ nord, admin, signFn, }) {
+        this.nord = nord;
+        this.admin = admin;
+        this.signFn = signFn;
+    }
+    /** Create a new admin client.
+     *
+     * @param nord - Nord instance
+     * @param admin - The user that will be signing actions.
+     * @param signFn - Function to sign messages with the admin's wallet.
+     *
+     * `signFn` must sign the _hex-encoded_ message, not the raw message itself, for
+     * the purpose of being compatible with Solana wallets.
+     *
+     * In practice, you will do something along the lines of:
+     *
+     * ```typescript
+     * (x) => wallet.signMessage(new TextEncoder().encode(x.toHex()));
+     * ```
+     *
+     * For a software signing key, this might look more like:
+     *
+     * ```typescript
+     * (x) => nacl.sign.detached(new TextEncoder().encode(x.toHex()), sk);
+     * ``
+     *
+     * where `nacl` is the tweetnacl library.
+     */
+    static new({ nord, admin, signFn, }) {
+        return new NordAdmin({
+            nord,
+            admin,
+            signFn,
+        });
+    }
+    /**
+     * Submit an action and append the admin signature before sending it to Nord.
+     *
+     * @param kind - Action payload describing the admin request
+     * @throws {NordError} If signing or submission fails
+     */
+    async submitAction(kind) {
+        const timestamp = await this.nord.getTimestamp();
+        const action = (0, actions_1.createAction)(timestamp, 0, kind);
+        return (0, actions_1.sendAction)(this.nord.webServerUrl, async (xs) => {
+            const signature = await this.signFn(xs);
+            if (signature.length !== 64) {
+                throw new NordError_1.NordError("invalid signature length; must be 64 bytes");
+            }
+            return Uint8Array.from([...xs, ...signature]);
+        }, action, this.nord.client);
+    }
+    /** Set acl permissions for a given user.
+     *
+     * If all roles are removed, the user is removed from the acl.
+     *
+     * @param target - User to update.
+     * @param addRoles - Roles to add to the user.
+     * @param removeRoles - Reles to remove from the user.
+     */
+    async updateAcl({ target, addRoles, removeRoles, }) {
+        const allRoles = addRoles.concat(removeRoles);
+        if (allRoles.length !== new Set(allRoles).size) {
+            throw new NordError_1.NordError("duplicate roles in acl update; must be unique");
+        }
+        let mask = 0;
+        let values = 0;
+        for (const role of allRoles) {
+            mask |= role;
+        }
+        for (const role of addRoles) {
+            values |= role;
+        }
+        const receipt = await this.submitAction({
+            case: "updateAcl",
+            value: (0, protobuf_1.create)(proto.Action_UpdateAclSchema, {
+                aclPubkey: this.admin.toBytes(),
+                targetPubkey: target.toBytes(),
+                rolesValue: values,
+                rolesMask: mask,
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "aclUpdated", "update acl");
+        return { ...receipt.kind.value, actionId: receipt.actionId };
+    }
+    /**
+     * Register a new token that can be listed on Nord.
+     *
+     * @param mintAddr - SPL mint to register
+     * @param tokenDecimals - On-chain decimal precision
+     * @param weightBps - Risk weight in basis points
+     * @param viewSymbol - Symbol shown to users
+     * @param oracleSymbol - Symbol used by the oracle
+     * @returns Action identifier and resulting token metadata
+     * @throws {NordError} If the action submission fails
+     */
+    async createToken({ mintAddr, tokenDecimals, weightBps, viewSymbol, oracleSymbol, }) {
+        const receipt = await this.submitAction({
+            case: "createToken",
+            value: (0, protobuf_1.create)(proto.Action_CreateTokenSchema, {
+                aclPubkey: this.admin.toBytes(),
+                tokenDecimals,
+                weightBps,
+                viewSymbol,
+                oracleSymbol,
+                solAddr: mintAddr.toBytes(),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "insertTokenResult", "create token");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Open a new market with explicit trading parameters.
+     *
+     * @param sizeDecimals - Base asset decimal precision
+     * @param priceDecimals - Quote price decimal precision
+     * @param imfBps - Initial margin fraction in basis points
+     * @param cmfBps - Cancel margin fraction in basis points
+     * @param mmfBps - Maintenance margin fraction in basis points
+     * @param marketType - Market kind to open
+     * @param viewSymbol - Symbol shown to users
+     * @param oracleSymbol - Symbol used by the oracle
+     * @param baseTokenId - Token id used as the base asset
+     * @returns Action identifier and resulting market metadata
+     * @throws {NordError} If the action submission fails
+     */
+    async createMarket({ sizeDecimals, priceDecimals, imfBps, cmfBps, mmfBps, marketType, viewSymbol, oracleSymbol, baseTokenId, }) {
+        const receipt = await this.submitAction({
+            case: "createMarket",
+            value: (0, protobuf_1.create)(proto.Action_CreateMarketSchema, {
+                aclPubkey: this.admin.toBytes(),
+                sizeDecimals,
+                priceDecimals,
+                imfBps,
+                cmfBps,
+                mmfBps,
+                marketType,
+                viewSymbol,
+                oracleSymbol,
+                baseTokenId,
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "insertMarketResult", "create market");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Update the Pyth guardian set used for verifying Wormhole messages.
+     *
+     * Each address must decode from a 20-byte hex string (with or without a
+     * leading `0x` prefix). The engine validates the supplied guardian set index
+     * before applying the update.
+     *
+     * @param guardianSetIndex - Wormhole guardian set identifier
+     * @param guardianAddresses - Guardian addresses as 20-byte hex strings
+     * @returns Action identifier and guardian update receipt
+     * @throws {NordError} If the action submission fails
+     */
+    async pythSetWormholeGuardians({ guardianSetIndex, addresses: guardianAddresses, }) {
+        const addresses = guardianAddresses.map((address) => {
+            try {
+                const decoded = (0, utils_1.decodeHex)(address);
+                if (decoded.length !== 20) {
+                    throw new Error("guardian address must be 20 bytes");
+                }
+                return decoded;
+            }
+            catch (e) {
+                throw new NordError_1.NordError("invalid guardian address; must be a 20 byte hex address", { cause: e });
+            }
+        });
+        const receipt = await this.submitAction({
+            case: "pythSetWormholeGuardians",
+            value: (0, protobuf_1.create)(proto.Action_PythSetWormholeGuardiansSchema, {
+                aclPubkey: this.admin.toBytes(),
+                guardianSetIndex,
+                addresses,
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "updateGuardianSetResult", "update wormhole guardians");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Link an oracle symbol to a specific Pyth price feed.
+     *
+     * The price feed identifier must decode to 32 bytes (with or without a
+     * leading `0x` prefix). Use this call to create or update the mapping used
+     * by the oracle integration.
+     *
+     * @param oracleSymbol - Symbol to update
+     * @param priceFeedHex - 32-byte hex price feed id
+     * @returns Action identifier and symbol feed receipt
+     * @throws {NordError} If the action submission fails
+     */
+    async pythSetSymbolFeed({ oracleSymbol, priceFeedId: priceFeedHex, }) {
+        let priceFeedId;
+        try {
+            priceFeedId = (0, utils_1.decodeHex)(priceFeedHex);
+            if (priceFeedId.length !== 32) {
+                throw new Error("price feed id must be 32 bytes");
+            }
+        }
+        catch (e) {
+            throw new NordError_1.NordError("invalid price feed id; must be a 32 byte hex id", {
+                cause: e,
+            });
+        }
+        const receipt = await this.submitAction({
+            case: "pythSetSymbolFeed",
+            value: (0, protobuf_1.create)(proto.Action_PythSetSymbolFeedSchema, {
+                aclPubkey: this.admin.toBytes(),
+                oracleSymbol,
+                priceFeedId,
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "oracleSymbolFeedResult", "set symbol feed");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Pause all trading activity on the exchange.
+     *
+     * @returns Action identifier confirming the pause
+     * @throws {NordError} If the action submission fails
+     */
+    async pause() {
+        const receipt = await this.submitAction({
+            case: "pause",
+            value: (0, protobuf_1.create)(proto.Action_PauseSchema, {
+                aclPubkey: this.admin.toBytes(),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "paused", "pause");
+        return { actionId: receipt.actionId };
+    }
+    /**
+     * Resume trading activity after a pause.
+     *
+     * @returns Action identifier confirming the unpause
+     * @throws {NordError} If the action submission fails
+     */
+    async unpause() {
+        const receipt = await this.submitAction({
+            case: "unpause",
+            value: (0, protobuf_1.create)(proto.Action_UnpauseSchema, {
+                aclPubkey: this.admin.toBytes(),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "unpaused", "unpause");
+        return { actionId: receipt.actionId };
+    }
+    /**
+     * Freeze an individual market, preventing new trades and orders.
+     *
+     * @param marketId - Target market identifier
+     * @returns Action identifier and freeze receipt
+     * @throws {NordError} If the action submission fails
+     */
+    async freezeMarket({ marketId, }) {
+        const receipt = await this.submitAction({
+            case: "freezeMarket",
+            value: (0, protobuf_1.create)(proto.Action_FreezeMarketSchema, {
+                marketId,
+                aclPubkey: this.admin.toBytes(),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "marketFreezeUpdated", "freeze market");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Unfreeze a market that was previously halted.
+     *
+     * @param marketId - Target market identifier
+     * @returns Action identifier and freeze receipt
+     * @throws {NordError} If the action submission fails
+     */
+    async unfreezeMarket({ marketId, }) {
+        const receipt = await this.submitAction({
+            case: "unfreezeMarket",
+            value: (0, protobuf_1.create)(proto.Action_UnfreezeMarketSchema, {
+                marketId,
+                aclPubkey: this.admin.toBytes(),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "marketFreezeUpdated", "unfreeze market");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Append a new fee tier to the account bracket configuration.
+     *
+     * - The engine supports at most 16 tiers (ids 0–15). Tier 0 is reserved for
+     *   the default Nord fees; use `updateFeeTier` if you need to change it.
+     * - The first appended tier receives id 1, and subsequent tiers increment the id.
+     *
+     * @param config - Maker/taker configuration to insert
+     * @returns Action identifier and fee tier addition receipt
+     * @throws {NordError} If the action submission fails or the new tier exceeds the maximum range (0-15).
+     */
+    async addFeeTier(config) {
+        const receipt = await this.submitAction({
+            case: "addFeeTier",
+            value: (0, protobuf_1.create)(proto.Action_AddFeeTierSchema, {
+                aclPubkey: this.admin.toBytes(),
+                config: (0, protobuf_1.create)(proto.FeeTierConfigSchema, config),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "feeTierAdded", "add fee tier");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Update an existing fee tier with new maker/taker rates.
+     *
+     * Tier identifiers must already exist; attempting to update a missing tier
+     * causes the action to fail.
+     *
+     * @param tierId - Fee tier identifier
+     * @param config - Updated maker/taker configuration
+     * @returns Action identifier and fee tier update receipt
+     * @throws {NordError} If the action submission fails or the tier ID exceeds the configured range.
+     */
+    async updateFeeTier({ tierId, config, }) {
+        const receipt = await this.submitAction({
+            case: "updateFeeTier",
+            value: (0, protobuf_1.create)(proto.Action_UpdateFeeTierSchema, {
+                aclPubkey: this.admin.toBytes(),
+                id: tierId,
+                config: (0, protobuf_1.create)(proto.FeeTierConfigSchema, config),
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "feeTierUpdated", "update fee tier");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+    /**
+     * Assign a fee tier to one or more accounts.
+     *
+     * The tier id must be within the configured range (0–15). Every account starts
+     * on tier 0; assigning it to another tier requires that tier to exist already.
+     * Invalid account ids or tier ids cause the action to fail.
+     *
+     * @param accounts - Account IDs to update
+     * @param tierId - Target fee tier identifier
+     * @returns Action identifier and accounts-tier receipt
+     * @throws {NordError} If the tier id exceeds the configured range or an account id is invalid.
+     */
+    async updateAccountsTier(accounts, tierId) {
+        const receipt = await this.submitAction({
+            case: "updateAccountsTier",
+            value: (0, protobuf_1.create)(proto.Action_UpdateAccountsTierSchema, {
+                aclPubkey: this.admin.toBytes(),
+                accounts,
+                tierId,
+            }),
+        });
+        (0, actions_1.expectReceiptKind)(receipt, "accountsTierUpdated", "update accounts tier");
+        return { actionId: receipt.actionId, ...receipt.kind.value };
+    }
+}
+exports.NordAdmin = NordAdmin;

package/dist/nord/client/NordClient.d.ts

@@ -0,0 +1,16 @@
+import { Client, FetchOptions } from "openapi-fetch";
+import type { paths } from "../../gen/openapi.ts";
+export declare class NordTransport {
+    readonly baseUrl: string;
+    private readonly client;
+    constructor(baseUrl: string);
+    get<P extends keyof paths & string>(path: P, options: FetchOptions<paths[P]["get"]>): Promise<import("openapi-fetch").ParseAsResponse<import("openapi-typescript-helpers").SuccessResponse<import("openapi-typescript-helpers").ResponseObjectMap<paths[P]["get"]>, `${string}/${string}`>, import("openapi-fetch").ParamsOption<paths[P]["get"]> & import("openapi-fetch").RequestBodyOption<paths[P]["get"]> & {
+        baseUrl?: string;
+        querySerializer?: import("openapi-fetch").QuerySerializerOptions | import("openapi-fetch").QuerySerializer<paths[P]["get"]> | undefined;
+        bodySerializer?: import("openapi-fetch").BodySerializer<paths[P]["get"]> | undefined;
+        parseAs?: import("openapi-fetch").ParseAs;
+        fetch?: import("openapi-fetch").ClientOptions["fetch"];
+        headers?: import("openapi-fetch").HeadersOptions;
+    } & Omit<RequestInit, "headers" | "body">> & ({} | null)>;
+    get clientInstance(): Client<paths>;
+}

package/dist/nord/client/NordClient.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NordTransport = void 0;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+const NordError_1 = require("../utils/NordError");
+class NordTransport {
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+        this.client = (0, openapi_fetch_1.default)({ baseUrl });
+    }
+    async get(path, options) {
+        const response = await this.client.GET(path, options);
+        if (response.error) {
+            throw new NordError_1.NordError(`failed to GET ${path}`, { cause: response.error });
+        }
+        if (response.data === undefined) {
+            throw new NordError_1.NordError("internal assertion violation", { cause: response });
+        }
+        return response.data;
+    }
+    get clientInstance() {
+        return this.client;
+    }
+}
+exports.NordTransport = NordTransport;