@mysten/deepbook-v3 2.9.1 → 2.10.0

package/dist/account.d.mts

@@ -1,8 +1,9 @@
 import { AccountConfig as AccountConfig$1 } from "./contracts/account/config-arguments.mjs";
 import { TESTNET_DEPLOYMENT, TESTNET_UNITS } from "./deployments/testnet.mjs";
 import { DeployedNetwork, NetworkArg, getDeployment, getUnits } from "./deployments/index.mjs";
-import { Account, AccountWrapper, account_d_exports } from "./contracts/account/account.mjs";
-import { account_registry_d_exports } from "./contracts/account/account_registry.mjs";
+import { Account, AccountWrapper } from "./contracts/account/account.mjs";
+import { account_d_exports } from "./account-bindings/account.mjs";
+import { account_registry_d_exports } from "./account-bindings/account-registry.mjs";
 import { account_events_d_exports } from "./contracts/account/account_events.mjs";
 import { Transaction, TransactionObjectArgument, TransactionResult } from "@mysten/sui/transactions";
 
@@ -22,10 +23,21 @@ import { Transaction, TransactionObjectArgument, TransactionResult } from "@myst
  * wrapper-address derivation needs plain ids.
  */
 interface AccountConfig extends AccountConfig$1 {
-  /** The `account` Move package id. */
+  /**
+   * The ORIGINAL `account` Move package id. Type tags and the derived wrapper address are built
+   * from it, so it never moves to an upgraded package: that would derive addresses nothing lives
+   * at, and a coin sent to one is lost.
+   */
   accountPackageId: string;
   /** The shared `AccountRegistry` object id. */
   accountRegistry: string;
+  /**
+   * The latest `account` package, once the network has upgraded it: the call target of every
+   * builder here. A PTB can't call account at an older version than another package in it links
+   * (Predict's Version 5 links account v2), and `receiveCoin` / `receiveCoinAtAccountId` exist
+   * only from v2. Absent while the network runs v1: calls then target `accountPackageId`.
+   */
+  accountPackageIdLatest?: string;
 }
 /**
  * @description The deployed `account` ids for `network`, so a caller does not transcribe
@@ -113,6 +125,37 @@ declare class AccountContract {
     amount: bigint;
     coinType: string;
   }): (tx: Transaction) => TransactionResult;
+  /**
+   * @description Move a `Coin<T>` that was transferred to an account's wrapper address into
+   * the account's stored balance (`receive_coin`). Permissionless: anyone may submit it, and
+   * value only enters the account the coin was addressed to. A sender that can only transfer a
+   * coin to an address (a bridge mint, for example) sends it to `deriveAccountWrapperId(owner)`.
+   * The coin can arrive before the account exists and waits there until the owner creates it.
+   * @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),
+   * and its coin type
+   * @returns A function that takes a Transaction object
+   * @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1
+   */
+  receiveCoin(params: {
+    wrapperId: string;
+    coin: string | TransactionObjectArgument;
+    coinType: string;
+  }): (tx: Transaction) => TransactionResult;
+  /**
+   * @description `receiveCoin` for a coin sent to the account's canonical ID (`account_id`,
+   * the address `account_registry::derived_address` returns) instead of its wrapper address.
+   * A `Receiving` input can't name its owner, so pick the call from where the coin sits: the
+   * wrong one aborts `EUnableToReceiveObject`. Senders should use the wrapper address.
+   * @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),
+   * and its coin type
+   * @returns A function that takes a Transaction object
+   * @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1
+   */
+  receiveCoinAtAccountId(params: {
+    wrapperId: string;
+    coin: string | TransactionObjectArgument;
+    coinType: string;
+  }): (tx: Transaction) => TransactionResult;
   /**
    * @description Borrow the `Account` out of its wrapper — the read-side entry point apps
    * chain their own getters onto (`account::balance<T>`, an app's own data accessors).

package/dist/account.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.mts","names":[],"sources":["../src/account.ts"],"mappings":";;;;;;;;;;;;AAqCA;;;;;;;;;AAiBA;;UAjBiB,aAAA,SAAsB,eAAA;EAiB6B;EAfnE,gBAAA;EAegC;EAbhC,eAAA;AAAA;;AAsCD;;;;;;;;;iBAzBgB,gBAAA,CAAiB,OAAA,EAAS,UAAA,GAAa,aAAA;;;;;;;;;;cAyB1C,eAAA;EAAA;EAMQ;;;cAAR,MAAA,EAAQ,aAAA;EA0BpB;;;;;;;EAfA,sBAAA,CAAuB,KAAA;EA0CW;;;;;;EA3BlC,YAAA,CAAA,IACS,EAAA,EAAI,WAAA,KAAc,iBAAA;EAgDJ;;;;;;EAtCvB,aAAA,CAAA,IACS,EAAA,EAAI,WAAA;EA0Db;;;;;;;;;EA3CA,uBAAA,CAAwB,MAAA;IAAU,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAC1D,EAAA,EAAI,WAAA;EA8Dc;;;;;;;EAzC3B,YAAA,CAAa,MAAA;IAAU,SAAA;IAAmB,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAClE,EAAA,EAAI,WAAA;;;;;;;;;EAoBb,aAAA,CAAc,MAAA;IAAU,SAAA;IAAmB,MAAA;IAAgB,QAAA;EAAA,KAClD,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;EAkB3B,WAAA,CAAY,MAAA;IAAU,SAAA;EAAA,KACb,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;EAW3B,OAAA,CAAQ,MAAA;IAAU,KAAA;IAAe,QAAA;EAAA,KACxB,EAAA,EAAI,WAAA,KAAc,iBAAA;AAAA"}
+{"version":3,"file":"account.d.mts","names":[],"sources":["../src/account.ts"],"mappings":";;;;;;;;;;;;;;AAqCA;;;;;;;;;;UAAiB,aAAA,SAAsB,eAAA;EA4BP;;;;;EAtB/B,gBAAA;EAsBmE;EApBnE,eAAA;EA6CY;;;;;;EAtCZ,sBAAA;AAAA;;;;;;;;;;;iBAae,gBAAA,CAAiB,OAAA,EAAS,UAAA,GAAa,aAAA;;;;;;;;;;cAyB1C,eAAA;EAAA;EAiBW;;;cAXX,MAAA,EAAQ,aAAA;EA2BO;;;;;;;EAhB3B,sBAAA,CAAuB,KAAA;EA0CC;;;;;;EA3BxB,YAAA,CAAA,IACS,EAAA,EAAI,WAAA,KAAc,iBAAA;EAgDgD;;;;;;EAtC3E,aAAA,CAAA,IACS,EAAA,EAAI,WAAA;EA0D8C;;;;;;;;;EA3C3D,uBAAA,CAAwB,MAAA;IAAU,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAC1D,EAAA,EAAI,WAAA;EAwEc;;;;;;;EAnD3B,YAAA,CAAa,MAAA;IAAU,SAAA;IAAmB,IAAA,EAAM,yBAAA;IAA2B,QAAA;EAAA,KAClE,EAAA,EAAI,WAAA;EA8GD;;;;;;;;EA1FZ,aAAA,CAAc,MAAA;IAAU,SAAA;IAAmB,MAAA;IAAgB,QAAA;EAAA,KAClD,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;;;;;EAuB3B,WAAA,CAAY,MAAA;IACX,SAAA;IACA,IAAA,WAAe,yBAAA;IACf,QAAA;EAAA,KAGQ,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;;;;EAuB3B,sBAAA,CAAuB,MAAA;IACtB,SAAA;IACA,IAAA,WAAe,yBAAA;IACf,QAAA;EAAA,KAGQ,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;EA+B3B,WAAA,CAAY,MAAA;IAAU,SAAA;EAAA,KACb,EAAA,EAAI,WAAA,KAAc,iBAAA;;;;;;;;EAW3B,OAAA,CAAQ,MAAA;IAAU,KAAA;IAAe,QAAA;EAAA,KACxB,EAAA,EAAI,WAAA,KAAc,iBAAA;AAAA"}

package/dist/account.mjs

@@ -1,5 +1,6 @@
-import { Account, AccountWrapper, account_exports, balance, depositFunds, generateAuth, loadAccount, share, withdrawFunds } from "./contracts/account/account.mjs";
-import { _new, account_registry_exports } from "./contracts/account/account_registry.mjs";
+import { Account, AccountWrapper } from "./contracts/account/account.mjs";
+import { account_exports, balance, depositFunds, generateAuth, loadAccount, receiveCoin, receiveCoinAtAccountId, share, withdrawFunds } from "./account-bindings/account.mjs";
+import { _new, account_registry_exports } from "./account-bindings/account-registry.mjs";
 import { MAINNET_ACCOUNT } from "./deployments/mainnet.mjs";
 import { TESTNET_ACCOUNT, TESTNET_DEPLOYMENT, TESTNET_UNITS } from "./deployments/testnet.mjs";
 import { getDeployment, getUnits } from "./deployments/index.mjs";
@@ -148,6 +149,54 @@ var AccountContract = class {
 		};
 	}
 	/**
+	* @description Move a `Coin<T>` that was transferred to an account's wrapper address into
+	* the account's stored balance (`receive_coin`). Permissionless: anyone may submit it, and
+	* value only enters the account the coin was addressed to. A sender that can only transfer a
+	* coin to an address (a bridge mint, for example) sends it to `deriveAccountWrapperId(owner)`.
+	* The coin can arrive before the account exists and waits there until the owner creates it.
+	* @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),
+	* and its coin type
+	* @returns A function that takes a Transaction object
+	* @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1
+	*/
+	receiveCoin(params) {
+		const packageId = this.#latestPackage("receiveCoin");
+		return (tx) => tx.add(receiveCoin({
+			package: packageId,
+			arguments: {
+				wrapper: params.wrapperId,
+				coin: typeof params.coin === "string" ? tx.object(params.coin) : params.coin
+			},
+			typeArguments: [params.coinType]
+		}));
+	}
+	/**
+	* @description `receiveCoin` for a coin sent to the account's canonical ID (`account_id`,
+	* the address `account_registry::derived_address` returns) instead of its wrapper address.
+	* A `Receiving` input can't name its owner, so pick the call from where the coin sits: the
+	* wrong one aborts `EUnableToReceiveObject`. Senders should use the wrapper address.
+	* @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),
+	* and its coin type
+	* @returns A function that takes a Transaction object
+	* @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1
+	*/
+	receiveCoinAtAccountId(params) {
+		const packageId = this.#latestPackage("receiveCoinAtAccountId");
+		return (tx) => tx.add(receiveCoinAtAccountId({
+			package: packageId,
+			arguments: {
+				wrapper: params.wrapperId,
+				coin: typeof params.coin === "string" ? tx.object(params.coin) : params.coin
+			},
+			typeArguments: [params.coinType]
+		}));
+	}
+	#latestPackage(builder) {
+		const latest = this.#config.accountPackageIdLatest;
+		if (!latest) throw new Error(`@mysten/deepbook-v3/account: ${builder} calls a function added in account v2, and this config has no \`accountPackageIdLatest\` (the network still runs account v1).`);
+		return latest;
+	}
+	/**
 	* @description Borrow the `Account` out of its wrapper — the read-side entry point apps
 	* chain their own getters onto (`account::balance<T>`, an app's own data accessors).
 	* @param {object} params Wrapper id

package/dist/account.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"account.mjs","names":["#config","account.generateAuth","accountRegistry._new","account.share","account.depositFunds","account.withdrawFunds","account.loadAccount","account.balance"],"sources":["../src/account.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { bcs } from '@mysten/sui/bcs';\nimport type {\n\tTransaction,\n\tTransactionObjectArgument,\n\tTransactionResult,\n} from '@mysten/sui/transactions';\nimport { deriveObjectID } from '@mysten/sui/utils';\n\nimport * as account from './contracts/account/account.js';\nimport * as accountRegistry from './contracts/account/account_registry.js';\nimport type { AccountConfig as GeneratedAccountConfig } from './contracts/account/config-arguments.js';\nimport { MAINNET_ACCOUNT } from './deployments/mainnet.js';\nimport { TESTNET_ACCOUNT } from './deployments/testnet.js';\nimport type { NetworkArg } from './deployments/index.js';\n\n// Provenance: which on-chain deployment the ids above came from. Re-exported so a consumer\n// can answer \"which deploy is this build pinned to?\" without reaching for another subpath.\nexport { getDeployment, getUnits, TESTNET_DEPLOYMENT, TESTNET_UNITS } from './deployments/index.js';\nexport type { NetworkArg } from './deployments/index.js';\nexport type { DeployedNetwork } from './deployments/index.js';\n\n/**\n * The deployed ids of the shared `account` package this contract builds against.\n *\n * Kept deliberately minimal — ids only — so any consumer of the shared account primitive\n * (DeepBook core's account wrapper, Predict, …) can drive these builders with its OWN\n * deployment's ids without constructing a full product-SDK config.\n *\n * Extends the codegen-generated config interface so there is exactly one config shape and\n * casing: the generated bindings resolve `options.config` against these same keys, and if\n * codegen adds, drops, or renames a key this file stops compiling instead of silently\n * building a PTB against the wrong object. The ids are narrowed to `string` — codegen types\n * the package id as optional and the registry as the wider `ConfigValue`, but the\n * wrapper-address derivation needs plain ids.\n */\nexport interface AccountConfig extends GeneratedAccountConfig {\n\t/** The `account` Move package id. */\n\taccountPackageId: string;\n\t/** The shared `AccountRegistry` object id. */\n\taccountRegistry: string;\n}\n\n/**\n * @description The deployed `account` ids for `network`, so a caller does not transcribe\n * them. Generated from the deploy manifest — see `src/deployments/`.\n * @throws if the network has no recorded deployment, rather than returning placeholder ids\n * that would fail as a confusing on-chain abort.\n *\n * ```ts\n * const account = new AccountContract(getAccountConfig('testnet'));\n * ```\n */\nexport function getAccountConfig(network: NetworkArg): AccountConfig {\n\tif (network === 'testnet') return TESTNET_ACCOUNT;\n\tif (network === 'mainnet') return MAINNET_ACCOUNT;\n\tthrow new Error(\n\t\t`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. ` +\n\t\t\t'The account primitive is recorded for testnet and mainnet; for your own deployment pass ' +\n\t\t\t'`{ accountPackageId, accountRegistry }` to AccountContract directly.',\n\t);\n}\n\n// `AccountWrapperKey(address)` is a one-field positional struct, so its BCS is just the\n// owner's 32-byte address. See `packages/account/sources/account_registry.move`.\nconst AccountWrapperKey = bcs.struct('AccountWrapperKey', {\n\tpos0: bcs.Address,\n});\n\n/**\n * AccountContract — the reusable on-chain account primitive (`packages/account`).\n *\n * An owner has one canonical `AccountWrapper`, a *derived* object of the account registry,\n * so its id is computable off-chain (no read). The wrapper holds an `Account` whose custody\n * balances apps deposit into and withdraw from; app-specific data hangs off it under an\n * app-keyed slot. Authority is a hot-potato `Auth` minted from the tx sender and consumed\n * by the very next account-loading call.\n */\nexport class AccountContract {\n\t#config: AccountConfig;\n\n\t/**\n\t * @param {AccountConfig} config Deployed ids of the shared `account` package\n\t */\n\tconstructor(config: AccountConfig) {\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * @description The deterministic id of an owner's canonical account wrapper — no chain\n\t * read needed. The wrapper is a derived object of the account registry, so its id is\n\t * `derive_address(registry, AccountWrapperKey(owner))`.\n\t * @param {string} owner Owner address\n\t * @returns The wrapper object id\n\t */\n\tderiveAccountWrapperId(owner: string): string {\n\t\tconst key = AccountWrapperKey.serialize({ pos0: owner }).toBytes();\n\t\treturn deriveObjectID(\n\t\t\tthis.#config.accountRegistry,\n\t\t\t`${this.#config.accountPackageId}::account_registry::AccountWrapperKey`,\n\t\t\tkey,\n\t\t);\n\t}\n\n\t/**\n\t * @description Mint owner authority for the transaction sender. A hot-potato `Auth`\n\t * consumed by the very next account-loading call (`load_account_mut` inside\n\t * `deposit_funds` / `withdraw_funds` / an app's own entrypoints).\n\t * @returns A function that takes a Transaction object\n\t */\n\tgenerateAuth() {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.generateAuth({ config: this.#config }));\n\t}\n\n\t/**\n\t * @description Create the sender's canonical account wrapper and share it. `new` derives\n\t * the wrapper at its deterministic address (see `deriveAccountWrapperId`) and aborts if\n\t * it already exists; `share` publishes the shared object apps borrow against.\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccount() {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description First-time funding in ONE PTB: create the sender's wrapper, deposit\n\t * `coin` through the fresh handle, then `share` LAST (once shared, by-value use of the\n\t * handle is over). This cannot be split into `createAccount` + `depositFunds`: an object\n\t * input can only address an object that pre-exists the PTB, so a wrapper created inside\n\t * it is reachable only through `new`'s result handle.\n\t * @param {object} params Coin to deposit and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccountAndDeposit(params: { coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description Deposit a caller-provided `coin` into the account's stored balance via the\n\t * PTB-callable `deposit_funds` (folds settle → authorize → load → deposit; clock and\n\t * accumulator root auto-injected). The caller owns coin sourcing.\n\t * @param {object} params Wrapper id, coin to deposit, and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tdepositFunds(params: { wrapperId: string; coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Withdraw `amount` (raw u64 units) from the account's stored balance via\n\t * the PTB-callable `withdraw_funds` (folds settle → authorize → load → withdraw; clock\n\t * and accumulator root auto-injected), returning the minted `Coin<T>` for the caller to\n\t * transfer or compose.\n\t * @param {object} params Wrapper id, raw amount, and coin type\n\t * @returns A function that takes a Transaction object and returns the `Coin<T>`\n\t */\n\twithdrawFunds(params: { wrapperId: string; amount: bigint; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\treturn tx.add(\n\t\t\t\taccount.withdrawFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, amount: params.amount },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Borrow the `Account` out of its wrapper — the read-side entry point apps\n\t * chain their own getters onto (`account::balance<T>`, an app's own data accessors).\n\t * @param {object} params Wrapper id\n\t * @returns A function that takes a Transaction object and returns the `Account`\n\t */\n\tloadAccount(params: { wrapperId: string }) {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.loadAccount({ config: this.#config, arguments: { self: params.wrapperId } }));\n\t}\n\n\t/**\n\t * @description Read an owner's stored custody balance for a coin type: chains\n\t * `load_account(wrapper)` → `balance<T>(account, root, clock)`. Compose in a\n\t * dev-inspect/simulate PTB and read the u64 return of the LAST command.\n\t * @param {object} params Owner address and coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tbalance(params: { owner: string; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst acct = tx.add(\n\t\t\t\tthis.loadAccount({ wrapperId: this.deriveAccountWrapperId(params.owner) }),\n\t\t\t);\n\t\t\treturn tx.add(\n\t\t\t\taccount.balance({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t\targuments: { self: acct },\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n}\n\n// === Generated bindings ===\n// The move-call thunks and BCS structs, for consumers composing their own PTBs or\n// parsing account objects/events (e.g. `AccountWrapper.parse`, the event layouts).\n//\n// NOTE: `Account` here is the shared account primitive's custody account\n// (`account::account::Account`). It is deliberately NOT re-exported from this\n// package's root — the root already exports a different `Account`\n// (`@deepbook/core::account::Account`, the per-pool trading account) and the two\n// have unrelated layouts. Keep them separated by subpath.\nexport * as accountMoveCalls from './contracts/account/account.js';\nexport * as accountRegistryMoveCalls from './contracts/account/account_registry.js';\nexport * as accountEvents from './contracts/account/account_events.js';\nexport { Account, AccountWrapper } from './contracts/account/account.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,iBAAiB,SAAoC;AACpE,KAAI,YAAY,UAAW,QAAO;AAClC,KAAI,YAAY,UAAW,QAAO;AAClC,OAAM,IAAI,MACT,4EAA4E,QAAQ,mKAGpF;;AAKF,MAAM,oBAAoB,IAAI,OAAO,qBAAqB,EACzD,MAAM,IAAI,SACV,CAAC;;;;;;;;;;AAWF,IAAa,kBAAb,MAA6B;CAC5B;;;;CAKA,YAAY,QAAuB;AAClC,QAAKA,SAAU;;;;;;;;;CAUhB,uBAAuB,OAAuB;EAC7C,MAAM,MAAM,kBAAkB,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC,SAAS;AAClE,SAAO,eACN,MAAKA,OAAQ,iBACb,GAAG,MAAKA,OAAQ,iBAAiB,wCACjC,IACA;;;;;;;;CASF,eAAe;AACd,UAAQ,OACP,GAAG,IAAIC,aAAqB,EAAE,QAAQ,MAAKD,QAAS,CAAC,CAAC;;;;;;;;CASxD,gBAAgB;AACf,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;AACtE,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;;;CAa/E,wBAAwB,QAA+D;AACtF,UAAQ,OAA0B;GACjC,MAAM,UAAU,GAAG,IAAIE,KAAqB,EAAE,QAAQ,MAAKF,QAAS,CAAC,CAAC;GACtE,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE;KAAS;KAAM,MAAM,OAAO;KAAM;IAC/C,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;AACD,MAAG,IAAIG,MAAc;IAAE,QAAQ,MAAKH;IAAS,WAAW,EAAE,MAAM,SAAS;IAAE,CAAC,CAAC;;;;;;;;;;CAW/E,aAAa,QAAkF;AAC9F,UAAQ,OAA0B;GACjC,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,MAAG,IACFI,aAAqB;IACpB,QAAQ,MAAKJ;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,MAAM,OAAO;KAAM;IACjE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;;;CAYH,cAAc,QAAiE;AAC9E,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC;AACxC,UAAO,GAAG,IACTK,cAAsB;IACrB,QAAQ,MAAKL;IACb,WAAW;KAAE,SAAS,OAAO;KAAW;KAAM,QAAQ,OAAO;KAAQ;IACrE,eAAe,CAAC,OAAO,SAAS;IAChC,CAAC,CACF;;;;;;;;;CAUH,YAAY,QAA+B;AAC1C,UAAQ,OACP,GAAG,IAAIM,YAAoB;GAAE,QAAQ,MAAKN;GAAS,WAAW,EAAE,MAAM,OAAO,WAAW;GAAE,CAAC,CAAC;;;;;;;;;CAU9F,QAAQ,QAA6C;AACpD,UAAQ,OAAuC;GAC9C,MAAM,OAAO,GAAG,IACf,KAAK,YAAY,EAAE,WAAW,KAAK,uBAAuB,OAAO,MAAM,EAAE,CAAC,CAC1E;AACD,UAAO,GAAG,IACTO,QAAgB;IACf,QAAQ,MAAKP;IACb,eAAe,CAAC,OAAO,SAAS;IAChC,WAAW,EAAE,MAAM,MAAM;IACzB,CAAC,CACF"}
+{"version":3,"file":"account.mjs","names":["#config","account.generateAuth","accountRegistry._new","account.share","account.depositFunds","account.withdrawFunds","#latestPackage","account.receiveCoin","account.receiveCoinAtAccountId","account.loadAccount","account.balance"],"sources":["../src/account.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { bcs } from '@mysten/sui/bcs';\nimport type {\n\tTransaction,\n\tTransactionObjectArgument,\n\tTransactionResult,\n} from '@mysten/sui/transactions';\nimport { deriveObjectID } from '@mysten/sui/utils';\n\nimport * as account from './account-bindings/account.js';\nimport * as accountRegistry from './account-bindings/account-registry.js';\nimport type { AccountConfig as GeneratedAccountConfig } from './contracts/account/config-arguments.js';\nimport { MAINNET_ACCOUNT } from './deployments/mainnet.js';\nimport { TESTNET_ACCOUNT } from './deployments/testnet.js';\nimport type { NetworkArg } from './deployments/index.js';\n\n// Provenance: which on-chain deployment the ids above came from. Re-exported so a consumer\n// can answer \"which deploy is this build pinned to?\" without reaching for another subpath.\nexport { getDeployment, getUnits, TESTNET_DEPLOYMENT, TESTNET_UNITS } from './deployments/index.js';\nexport type { NetworkArg } from './deployments/index.js';\nexport type { DeployedNetwork } from './deployments/index.js';\n\n/**\n * The deployed ids of the shared `account` package this contract builds against.\n *\n * Kept deliberately minimal — ids only — so any consumer of the shared account primitive\n * (DeepBook core's account wrapper, Predict, …) can drive these builders with its OWN\n * deployment's ids without constructing a full product-SDK config.\n *\n * Extends the codegen-generated config interface so there is exactly one config shape and\n * casing: the generated bindings resolve `options.config` against these same keys, and if\n * codegen adds, drops, or renames a key this file stops compiling instead of silently\n * building a PTB against the wrong object. The ids are narrowed to `string` — codegen types\n * the package id as optional and the registry as the wider `ConfigValue`, but the\n * wrapper-address derivation needs plain ids.\n */\nexport interface AccountConfig extends GeneratedAccountConfig {\n\t/**\n\t * The ORIGINAL `account` Move package id. Type tags and the derived wrapper address are built\n\t * from it, so it never moves to an upgraded package: that would derive addresses nothing lives\n\t * at, and a coin sent to one is lost.\n\t */\n\taccountPackageId: string;\n\t/** The shared `AccountRegistry` object id. */\n\taccountRegistry: string;\n\t/**\n\t * The latest `account` package, once the network has upgraded it: the call target of every\n\t * builder here. A PTB can't call account at an older version than another package in it links\n\t * (Predict's Version 5 links account v2), and `receiveCoin` / `receiveCoinAtAccountId` exist\n\t * only from v2. Absent while the network runs v1: calls then target `accountPackageId`.\n\t */\n\taccountPackageIdLatest?: string;\n}\n\n/**\n * @description The deployed `account` ids for `network`, so a caller does not transcribe\n * them. Generated from the deploy manifest — see `src/deployments/`.\n * @throws if the network has no recorded deployment, rather than returning placeholder ids\n * that would fail as a confusing on-chain abort.\n *\n * ```ts\n * const account = new AccountContract(getAccountConfig('testnet'));\n * ```\n */\nexport function getAccountConfig(network: NetworkArg): AccountConfig {\n\tif (network === 'testnet') return TESTNET_ACCOUNT;\n\tif (network === 'mainnet') return MAINNET_ACCOUNT;\n\tthrow new Error(\n\t\t`@mysten/deepbook-v3/account: no account deployment recorded for network '${network}'. ` +\n\t\t\t'The account primitive is recorded for testnet and mainnet; for your own deployment pass ' +\n\t\t\t'`{ accountPackageId, accountRegistry }` to AccountContract directly.',\n\t);\n}\n\n// `AccountWrapperKey(address)` is a one-field positional struct, so its BCS is just the\n// owner's 32-byte address. See `packages/account/sources/account_registry.move`.\nconst AccountWrapperKey = bcs.struct('AccountWrapperKey', {\n\tpos0: bcs.Address,\n});\n\n/**\n * AccountContract — the reusable on-chain account primitive (`packages/account`).\n *\n * An owner has one canonical `AccountWrapper`, a *derived* object of the account registry,\n * so its id is computable off-chain (no read). The wrapper holds an `Account` whose custody\n * balances apps deposit into and withdraw from; app-specific data hangs off it under an\n * app-keyed slot. Authority is a hot-potato `Auth` minted from the tx sender and consumed\n * by the very next account-loading call.\n */\nexport class AccountContract {\n\t#config: AccountConfig;\n\n\t/**\n\t * @param {AccountConfig} config Deployed ids of the shared `account` package\n\t */\n\tconstructor(config: AccountConfig) {\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * @description The deterministic id of an owner's canonical account wrapper — no chain\n\t * read needed. The wrapper is a derived object of the account registry, so its id is\n\t * `derive_address(registry, AccountWrapperKey(owner))`.\n\t * @param {string} owner Owner address\n\t * @returns The wrapper object id\n\t */\n\tderiveAccountWrapperId(owner: string): string {\n\t\tconst key = AccountWrapperKey.serialize({ pos0: owner }).toBytes();\n\t\treturn deriveObjectID(\n\t\t\tthis.#config.accountRegistry,\n\t\t\t`${this.#config.accountPackageId}::account_registry::AccountWrapperKey`,\n\t\t\tkey,\n\t\t);\n\t}\n\n\t/**\n\t * @description Mint owner authority for the transaction sender. A hot-potato `Auth`\n\t * consumed by the very next account-loading call (`load_account_mut` inside\n\t * `deposit_funds` / `withdraw_funds` / an app's own entrypoints).\n\t * @returns A function that takes a Transaction object\n\t */\n\tgenerateAuth() {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.generateAuth({ config: this.#config }));\n\t}\n\n\t/**\n\t * @description Create the sender's canonical account wrapper and share it. `new` derives\n\t * the wrapper at its deterministic address (see `deriveAccountWrapperId`) and aborts if\n\t * it already exists; `share` publishes the shared object apps borrow against.\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccount() {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description First-time funding in ONE PTB: create the sender's wrapper, deposit\n\t * `coin` through the fresh handle, then `share` LAST (once shared, by-value use of the\n\t * handle is over). This cannot be split into `createAccount` + `depositFunds`: an object\n\t * input can only address an object that pre-exists the PTB, so a wrapper created inside\n\t * it is reachable only through `new`'s result handle.\n\t * @param {object} params Coin to deposit and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tcreateAccountAndDeposit(params: { coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst wrapper = tx.add(accountRegistry._new({ config: this.#config }));\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t\ttx.add(account.share({ config: this.#config, arguments: { self: wrapper } }));\n\t\t};\n\t}\n\n\t/**\n\t * @description Deposit a caller-provided `coin` into the account's stored balance via the\n\t * PTB-callable `deposit_funds` (folds settle → authorize → load → deposit; clock and\n\t * accumulator root auto-injected). The caller owns coin sourcing.\n\t * @param {object} params Wrapper id, coin to deposit, and its coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tdepositFunds(params: { wrapperId: string; coin: TransactionObjectArgument; coinType: string }) {\n\t\treturn (tx: Transaction): void => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\ttx.add(\n\t\t\t\taccount.depositFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, coin: params.coin },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Withdraw `amount` (raw u64 units) from the account's stored balance via\n\t * the PTB-callable `withdraw_funds` (folds settle → authorize → load → withdraw; clock\n\t * and accumulator root auto-injected), returning the minted `Coin<T>` for the caller to\n\t * transfer or compose.\n\t * @param {object} params Wrapper id, raw amount, and coin type\n\t * @returns A function that takes a Transaction object and returns the `Coin<T>`\n\t */\n\twithdrawFunds(params: { wrapperId: string; amount: bigint; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst auth = tx.add(this.generateAuth());\n\t\t\treturn tx.add(\n\t\t\t\taccount.withdrawFunds({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\targuments: { wrapper: params.wrapperId, auth, amount: params.amount },\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n\n\t/**\n\t * @description Move a `Coin<T>` that was transferred to an account's wrapper address into\n\t * the account's stored balance (`receive_coin`). Permissionless: anyone may submit it, and\n\t * value only enters the account the coin was addressed to. A sender that can only transfer a\n\t * coin to an address (a bridge mint, for example) sends it to `deriveAccountWrapperId(owner)`.\n\t * The coin can arrive before the account exists and waits there until the owner creates it.\n\t * @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),\n\t * and its coin type\n\t * @returns A function that takes a Transaction object\n\t * @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1\n\t */\n\treceiveCoin(params: {\n\t\twrapperId: string;\n\t\tcoin: string | TransactionObjectArgument;\n\t\tcoinType: string;\n\t}) {\n\t\tconst packageId = this.#latestPackage('receiveCoin');\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(\n\t\t\t\taccount.receiveCoin({\n\t\t\t\t\tpackage: packageId,\n\t\t\t\t\targuments: {\n\t\t\t\t\t\twrapper: params.wrapperId,\n\t\t\t\t\t\tcoin: typeof params.coin === 'string' ? tx.object(params.coin) : params.coin,\n\t\t\t\t\t},\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t}\n\n\t/**\n\t * @description `receiveCoin` for a coin sent to the account's canonical ID (`account_id`,\n\t * the address `account_registry::derived_address` returns) instead of its wrapper address.\n\t * A `Receiving` input can't name its owner, so pick the call from where the coin sits: the\n\t * wrong one aborts `EUnableToReceiveObject`. Senders should use the wrapper address.\n\t * @param {object} params Wrapper id, the received coin's object id (or a `Receiving` input),\n\t * and its coin type\n\t * @returns A function that takes a Transaction object\n\t * @throws if the config has no `accountPackageIdLatest`, i.e. the network still runs account v1\n\t */\n\treceiveCoinAtAccountId(params: {\n\t\twrapperId: string;\n\t\tcoin: string | TransactionObjectArgument;\n\t\tcoinType: string;\n\t}) {\n\t\tconst packageId = this.#latestPackage('receiveCoinAtAccountId');\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(\n\t\t\t\taccount.receiveCoinAtAccountId({\n\t\t\t\t\tpackage: packageId,\n\t\t\t\t\targuments: {\n\t\t\t\t\t\twrapper: params.wrapperId,\n\t\t\t\t\t\tcoin: typeof params.coin === 'string' ? tx.object(params.coin) : params.coin,\n\t\t\t\t\t},\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t}),\n\t\t\t);\n\t}\n\n\t// The call target for the functions added in account v2, which v1 doesn't have.\n\t#latestPackage(builder: string): string {\n\t\tconst latest = this.#config.accountPackageIdLatest;\n\t\tif (!latest) {\n\t\t\tthrow new Error(\n\t\t\t\t`@mysten/deepbook-v3/account: ${builder} calls a function added in account v2, and this ` +\n\t\t\t\t\t'config has no `accountPackageIdLatest` (the network still runs account v1).',\n\t\t\t);\n\t\t}\n\t\treturn latest;\n\t}\n\n\t/**\n\t * @description Borrow the `Account` out of its wrapper — the read-side entry point apps\n\t * chain their own getters onto (`account::balance<T>`, an app's own data accessors).\n\t * @param {object} params Wrapper id\n\t * @returns A function that takes a Transaction object and returns the `Account`\n\t */\n\tloadAccount(params: { wrapperId: string }) {\n\t\treturn (tx: Transaction): TransactionResult =>\n\t\t\ttx.add(account.loadAccount({ config: this.#config, arguments: { self: params.wrapperId } }));\n\t}\n\n\t/**\n\t * @description Read an owner's stored custody balance for a coin type: chains\n\t * `load_account(wrapper)` → `balance<T>(account, root, clock)`. Compose in a\n\t * dev-inspect/simulate PTB and read the u64 return of the LAST command.\n\t * @param {object} params Owner address and coin type\n\t * @returns A function that takes a Transaction object\n\t */\n\tbalance(params: { owner: string; coinType: string }) {\n\t\treturn (tx: Transaction): TransactionResult => {\n\t\t\tconst acct = tx.add(\n\t\t\t\tthis.loadAccount({ wrapperId: this.deriveAccountWrapperId(params.owner) }),\n\t\t\t);\n\t\t\treturn tx.add(\n\t\t\t\taccount.balance({\n\t\t\t\t\tconfig: this.#config,\n\t\t\t\t\ttypeArguments: [params.coinType],\n\t\t\t\t\targuments: { self: acct },\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t}\n}\n\n// === Generated bindings ===\n// The move-call thunks and BCS structs, for consumers composing their own PTBs or\n// parsing account objects/events (e.g. `AccountWrapper.parse`, the event layouts).\n//\n// NOTE: `Account` here is the shared account primitive's custody account\n// (`account::account::Account`). It is deliberately NOT re-exported from this\n// package's root — the root already exports a different `Account`\n// (`@deepbook/core::account::Account`, the per-pool trading account) and the two\n// have unrelated layouts. Keep them separated by subpath.\n// The move calls resolve their package to `config.accountPackageIdLatest` when the config has one\n// (see `account-bindings/latest.ts`); `accountPackageId` stays the original for derivation.\nexport * as accountMoveCalls from './account-bindings/account.js';\nexport * as accountRegistryMoveCalls from './account-bindings/account-registry.js';\nexport * as accountEvents from './contracts/account/account_events.js';\nexport { Account, AccountWrapper } from './contracts/account/account.js';\n"],"mappings":"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"}

package/dist/client.d.mts

@@ -163,7 +163,7 @@ declare class DeepBookClient {
   }[] | null>;
   getLevel2Range(poolKey: string, priceLow: number | bigint, priceHigh: number | bigint, isBid: boolean): Promise<Level2Range>;
   getLevel2TicksFromMid(poolKey: string, ticks: number): Promise<Level2TicksFromMid>;
-  getAccountOrderDetails(poolKey: string, managerKey: string): Promise<[] | {
+  getAccountOrderDetails(poolKey: string, managerKey: string): Promise<{
     balance_manager_id: string;
     order_id: string;
     client_order_id: string;
@@ -177,7 +177,7 @@ declare class DeepBookClient {
     epoch: string;
     status: number;
     expire_timestamp: string;
-  }[]>;
+  }[] | []>;
   account(poolKey: string, managerKey: string): Promise<AccountInfo>;
   lockedBalance(poolKey: string, balanceManagerKey: string): Promise<LockedBalances>;
   getPoolDeepPrice(poolKey: string): Promise<PoolDeepPrice>;

package/dist/contracts/account/account.d.mts

@@ -1,12 +1,8 @@
 import { MoveStruct, MoveTuple, RawTransactionArgument } from "../utils/index.mjs";
 import { BcsType } from "@mysten/sui/bcs";
-import * as _mysten_sui_transactions0 from "@mysten/sui/transactions";
 import { Transaction, TransactionArgument } from "@mysten/sui/transactions";
 
 //#region src/contracts/account/account.d.ts
-declare namespace account_d_exports {
-  export { Account, AccountIdArguments, AccountIdOptions, AccountWrapper, AttachArguments, AttachOptions, Auth, BalanceArguments, BalanceOptions, BorrowDataArguments, BorrowDataMutArguments, BorrowDataMutOptions, BorrowDataOptions, CoinKey, DataKey, DepositArguments, DepositFundsArguments, DepositFundsOptions, DepositOptions, DetachArguments, DetachOptions, GenerateAuthAsObjectArguments, GenerateAuthAsObjectOptions, GenerateAuthOptions, HasDataArguments, HasDataOptions, IdArguments, IdOptions, LoadAccountArguments, LoadAccountMutArguments, LoadAccountMutOptions, LoadAccountOptions, OwnerArguments, OwnerOptions, ReceiveAddressArguments, ReceiveAddressOptions, ReferrerAccountIdArguments, ReferrerAccountIdOptions, ReferrerReceiveAddressArguments, ReferrerReceiveAddressOptions, SettleArguments, SettleOptions, ShareArguments, ShareOptions, WithdrawArguments, WithdrawFundsArguments, WithdrawFundsOptions, WithdrawOptions, accountId, attach, balance, borrowData, borrowDataMut, deposit, depositFunds, detach, generateAuth, generateAuthAsObject, hasData, id, loadAccount, loadAccountMut, owner, receiveAddress, referrerAccountId, referrerReceiveAddress, settle, share, withdraw, withdrawFunds };
-}
 declare const Account: MoveStruct<{
   /** Dynamic-field parent for account-owned application data. */account_id: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">; /** EOA address or object-ID-as-address that owns this account. */
   owner: BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">; /** Wrapper-object address used as the accumulator delivery and withdrawal anchor. */
@@ -56,8 +52,6 @@ interface IdOptions {
     accountPackageId?: string;
   };
 }
-/** Returns the wrapper object ID. */
-declare function id(options: IdOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface LoadAccountArguments {
   self: RawTransactionArgument<string>;
 }
@@ -68,8 +62,6 @@ interface LoadAccountOptions {
     accountPackageId?: string;
   };
 }
-/** Borrows the wrapped account for read-only composition. */
-declare function loadAccount(options: LoadAccountOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface BalanceArguments {
   self: TransactionArgument;
 }
@@ -81,11 +73,6 @@ interface BalanceOptions {
   };
   typeArguments: [string];
 }
-/**
- * Returns the total balance of `T` available to the account, including funds
- * delivered through the ambient accumulator but not yet settled into the account.
- */
-declare function balance(options: BalanceOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface OwnerArguments {
   self: TransactionArgument;
 }
@@ -96,11 +83,6 @@ interface OwnerOptions {
     accountPackageId?: string;
   };
 }
-/**
- * Returns the account owner address. This may be an EOA address or an
- * object-ID-as-address.
- */
-declare function owner(options: OwnerOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface AccountIdArguments {
   self: TransactionArgument;
 }
@@ -111,8 +93,6 @@ interface AccountIdOptions {
     accountPackageId?: string;
   };
 }
-/** Returns the canonical account ID. */
-declare function accountId(options: AccountIdOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface ReferrerAccountIdArguments {
   self: TransactionArgument;
 }
@@ -123,11 +103,6 @@ interface ReferrerAccountIdOptions {
     accountPackageId?: string;
   };
 }
-/**
- * Returns the canonical referrer account ID recorded at creation for external Move
- * composition.
- */
-declare function referrerAccountId(options: ReferrerAccountIdOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface ReferrerReceiveAddressArguments {
   self: TransactionArgument;
 }
@@ -138,11 +113,6 @@ interface ReferrerReceiveAddressOptions {
     accountPackageId?: string;
   };
 }
-/**
- * Returns the referrer's accumulator receive address for external Move
- * composition.
- */
-declare function referrerReceiveAddress(options: ReferrerReceiveAddressOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface ReceiveAddressArguments {
   self: TransactionArgument;
 }
@@ -153,8 +123,6 @@ interface ReceiveAddressOptions {
     accountPackageId?: string;
   };
 }
-/** Returns the accumulator receive address for this account (the wrapper address). */
-declare function receiveAddress(options: ReceiveAddressOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface GenerateAuthOptions {
   package?: string;
   arguments?: [];
@@ -162,8 +130,6 @@ interface GenerateAuthOptions {
     accountPackageId?: string;
   };
 }
-/** Creates owner authority bound to the transaction sender. */
-declare function generateAuth(options?: GenerateAuthOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface GenerateAuthAsObjectArguments {
   uid: RawTransactionArgument<string>;
 }
@@ -174,8 +140,6 @@ interface GenerateAuthAsObjectOptions {
     accountPackageId?: string;
   };
 }
-/** Creates owner authority bound to an owning object's address. */
-declare function generateAuthAsObject(options: GenerateAuthAsObjectOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface ShareArguments {
   self: RawTransactionArgument<string>;
 }
@@ -186,8 +150,6 @@ interface ShareOptions {
     accountPackageId?: string;
   };
 }
-/** Shares a newly created account wrapper. */
-declare function share(options: ShareOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface LoadAccountMutArguments {
   self: RawTransactionArgument<string>;
   auth: TransactionArgument;
@@ -199,12 +161,6 @@ interface LoadAccountMutOptions {
     accountPackageId?: string;
   };
 }
-/**
- * Consumes owner or app authority and returns the account's full mutable surface.
- * Owner authority must match the stored owner; app authority is package-issued
- * after registry authorization and carries no owner or operation restriction.
- */
-declare function loadAccountMut(options: LoadAccountMutOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface SettleArguments {
   wrapper: RawTransactionArgument<string>;
 }
@@ -216,15 +172,30 @@ interface SettleOptions {
   };
   typeArguments: [string];
 }
-/**
- * Permissionlessly folds accumulator-delivered `T` at the wrapper address into
- * stored account balance. The per-coin timestamp is latched before reading the
- * accumulator, preventing duplicate withdrawal and same-timestamp double counting
- * even when no funds are available. Only the wrapper UID can authenticate the
- * address-balance withdrawal; value leaving the account still requires a mutable
- * borrow through `Auth`.
- */
-declare function settle(options: SettleOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
+interface ReceiveCoinArguments {
+  wrapper: RawTransactionArgument<string>;
+  coin: TransactionArgument;
+}
+interface ReceiveCoinOptions {
+  package?: string;
+  arguments: ReceiveCoinArguments | [wrapper: RawTransactionArgument<string>, coin: TransactionArgument];
+  config?: {
+    accountPackageId?: string;
+  };
+  typeArguments: [string];
+}
+interface ReceiveCoinAtAccountIdArguments {
+  wrapper: RawTransactionArgument<string>;
+  coin: TransactionArgument;
+}
+interface ReceiveCoinAtAccountIdOptions {
+  package?: string;
+  arguments: ReceiveCoinAtAccountIdArguments | [wrapper: RawTransactionArgument<string>, coin: TransactionArgument];
+  config?: {
+    accountPackageId?: string;
+  };
+  typeArguments: [string];
+}
 interface DepositArguments {
   self: TransactionArgument;
   coin: RawTransactionArgument<string>;
@@ -237,11 +208,6 @@ interface DepositOptions {
   };
   typeArguments: [string];
 }
-/**
- * Deposits into stored balance only; callers that include accumulator funds must
- * settle through the wrapper first.
- */
-declare function deposit(options: DepositOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface WithdrawArguments {
   self: TransactionArgument;
   amount: RawTransactionArgument<number | bigint>;
@@ -254,11 +220,6 @@ interface WithdrawOptions {
   };
   typeArguments: [string];
 }
-/**
- * Withdraws from stored balance only; callers that include accumulator funds must
- * settle through the wrapper first.
- */
-declare function withdraw(options: WithdrawOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface DepositFundsArguments {
   wrapper: RawTransactionArgument<string>;
   auth: TransactionArgument;
@@ -272,11 +233,6 @@ interface DepositFundsOptions {
   };
   typeArguments: [string];
 }
-/**
- * PTB entrypoint that settles accumulator funds, consumes authority, and deposits
- * into stored balance in one call.
- */
-declare function depositFunds(options: DepositFundsOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface WithdrawFundsArguments {
   wrapper: RawTransactionArgument<string>;
   auth: TransactionArgument;
@@ -290,11 +246,6 @@ interface WithdrawFundsOptions {
   };
   typeArguments: [string];
 }
-/**
- * PTB entrypoint that settles accumulator funds, consumes authority, and withdraws
- * from stored balance in one call.
- */
-declare function withdrawFunds(options: WithdrawFundsOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface AttachArguments<Data extends BcsType<any>> {
   self: TransactionArgument;
   Permit: TransactionArgument;
@@ -308,11 +259,6 @@ interface AttachOptions<Data extends BcsType<any>> {
   };
   typeArguments: [string, string];
 }
-/**
- * Attach an app's `Data` under its witness namespace. Requires `Permit<App>`.
- * Aborts if `App` already has data attached.
- */
-declare function attach<Data extends BcsType<any>>(options: AttachOptions<Data>): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface HasDataArguments {
   self: TransactionArgument;
 }
@@ -324,8 +270,6 @@ interface HasDataOptions {
   };
   typeArguments: [string];
 }
-/** Whether `App` has data attached to this account. */
-declare function hasData(options: HasDataOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface BorrowDataArguments {
   self: TransactionArgument;
 }
@@ -337,12 +281,6 @@ interface BorrowDataOptions {
   };
   typeArguments: [string, string];
 }
-/**
- * Borrow an app's attached `Data`. Open (no witness): the slot is namespaced by
- * `App` and on-chain state is public, so composing apps can read it. Aborts if
- * nothing is attached.
- */
-declare function borrowData(options: BorrowDataOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface BorrowDataMutArguments {
   self: TransactionArgument;
   Permit: TransactionArgument;
@@ -355,11 +293,6 @@ interface BorrowDataMutOptions {
   };
   typeArguments: [string, string];
 }
-/**
- * Mutably borrow an app's attached `Data`. Requires `Permit<App>`. Aborts if
- * nothing is attached.
- */
-declare function borrowDataMut(options: BorrowDataMutOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 interface DetachArguments {
   self: TransactionArgument;
   Permit: TransactionArgument;
@@ -372,11 +305,6 @@ interface DetachOptions {
   };
   typeArguments: [string, string];
 }
-/**
- * Detach and return an app's `Data`. Requires `Permit<App>`. Aborts if nothing is
- * attached.
- */
-declare function detach(options: DetachOptions): (tx: Transaction) => _mysten_sui_transactions0.TransactionResult;
 //#endregion
-export { Account, AccountWrapper, account_d_exports };
+export { Account, AccountIdArguments, AccountIdOptions, AccountWrapper, AttachArguments, AttachOptions, Auth, BalanceArguments, BalanceOptions, BorrowDataArguments, BorrowDataMutArguments, BorrowDataMutOptions, BorrowDataOptions, CoinKey, DataKey, DepositArguments, DepositFundsArguments, DepositFundsOptions, DepositOptions, DetachArguments, DetachOptions, GenerateAuthAsObjectArguments, GenerateAuthAsObjectOptions, GenerateAuthOptions, HasDataArguments, HasDataOptions, IdArguments, IdOptions, LoadAccountArguments, LoadAccountMutArguments, LoadAccountMutOptions, LoadAccountOptions, OwnerArguments, OwnerOptions, ReceiveAddressArguments, ReceiveAddressOptions, ReceiveCoinArguments, ReceiveCoinAtAccountIdArguments, ReceiveCoinAtAccountIdOptions, ReceiveCoinOptions, ReferrerAccountIdArguments, ReferrerAccountIdOptions, ReferrerReceiveAddressArguments, ReferrerReceiveAddressOptions, SettleArguments, SettleOptions, ShareArguments, ShareOptions, WithdrawArguments, WithdrawFundsArguments, WithdrawFundsOptions, WithdrawOptions };
 //# sourceMappingURL=account.d.mts.map

package/dist/contracts/account/account.d.mts.map

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

package/dist/contracts/account/account.mjs

@@ -1,4 +1,3 @@
-import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
 import { MoveStruct, MoveTuple, normalizeMoveArguments } from "../utils/index.mjs";
 import { Bag } from "./deps/sui/bag.mjs";
 import { bcs } from "@mysten/sui/bcs";
@@ -12,40 +11,11 @@ import { bcs } from "@mysten/sui/bcs";
 * application-scoped data. Consuming `Auth` is the mutable-borrow boundary: owner
 * auth is checked against the account, while package-issued app auth yields the
 * same full `&mut Account` and is not bound to an owner or operation. The wrapper
-* address receives accumulator funds; a distinct derived account UID identifies
-* the account and anchors app data, while typed balances remain embedded in the
-* account. App data is namespaced by witness type, requires `Permit<App>` to
-* mutate, and remains publicly readable.
+* address receives accumulator funds and transferred coins; a distinct derived
+* account UID identifies the account and anchors app data, while typed balances
+* remain embedded in the account. App data is namespaced by witness type, requires
+* `Permit<App>` to mutate, and remains publicly readable.
 */
-var account_exports = /* @__PURE__ */ __exportAll({
-	Account: () => Account,
-	AccountWrapper: () => AccountWrapper,
-	Auth: () => Auth,
-	CoinKey: () => CoinKey,
-	DataKey: () => DataKey,
-	accountId: () => accountId,
-	attach: () => attach,
-	balance: () => balance,
-	borrowData: () => borrowData,
-	borrowDataMut: () => borrowDataMut,
-	deposit: () => deposit,
-	depositFunds: () => depositFunds,
-	detach: () => detach,
-	generateAuth: () => generateAuth,
-	generateAuthAsObject: () => generateAuthAsObject,
-	hasData: () => hasData,
-	id: () => id,
-	loadAccount: () => loadAccount,
-	loadAccountMut: () => loadAccountMut,
-	owner: () => owner,
-	receiveAddress: () => receiveAddress,
-	referrerAccountId: () => referrerAccountId,
-	referrerReceiveAddress: () => referrerReceiveAddress,
-	settle: () => settle,
-	share: () => share,
-	withdraw: () => withdraw,
-	withdrawFunds: () => withdrawFunds
-});
 const $moduleName = "@local-pkg/account::account";
 const Account = new MoveStruct({
 	name: `${$moduleName}::Account`,
@@ -268,6 +238,44 @@ function settle(options) {
 	});
 }
 /**
+* Permissionlessly folds a `Coin<T>` transferred to the wrapper address into
+* stored account balance, for senders that can only transfer a coin and owners who
+* have not signed. Value only enters the account, and only the wrapper UID the
+* coin was addressed to can receive it. A coin may arrive before the account
+* exists: `account_registry::derived_wrapper_address` is its recipient.
+*/
+function receiveCoin(options) {
+	const packageAddress = options.package ?? options.config?.accountPackageId ?? "@local-pkg/account";
+	const argumentsTypes = [null, null];
+	const parameterNames = ["wrapper", "coin"];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "account",
+		function: "receive_coin",
+		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+		typeArguments: options.typeArguments
+	});
+}
+/**
+* `receive_coin` for a coin sent to the canonical account address, the account's
+* public identity, which can get copied as a destination. Senders should still use
+* the wrapper address, the one that also takes `send_funds`. A `Receiving` cannot
+* reveal its owner, so the caller picks the function from the coin's owner; the
+* wrong one aborts.
+*/
+function receiveCoinAtAccountId(options) {
+	const packageAddress = options.package ?? options.config?.accountPackageId ?? "@local-pkg/account";
+	const argumentsTypes = [null, null];
+	const parameterNames = ["wrapper", "coin"];
+	return (tx) => tx.moveCall({
+		package: packageAddress,
+		module: "account",
+		function: "receive_coin_at_account_id",
+		arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+		typeArguments: options.typeArguments
+	});
+}
+/**
 * Deposits into stored balance only; callers that include accumulator funds must
 * settle through the wrapper first.
 */
@@ -439,5 +447,5 @@ function detach(options) {
 }
 
 //#endregion
-export { Account, AccountWrapper, account_exports, balance, depositFunds, generateAuth, loadAccount, share, withdrawFunds };
+export { Account, AccountWrapper, Auth, CoinKey, DataKey, accountId, attach, balance, borrowData, borrowDataMut, deposit, depositFunds, detach, generateAuth, generateAuthAsObject, hasData, id, loadAccount, loadAccountMut, owner, receiveAddress, receiveCoin, receiveCoinAtAccountId, referrerAccountId, referrerReceiveAddress, settle, share, withdraw, withdrawFunds };
 //# sourceMappingURL=account.mjs.map