@mysten/kiosk 0.14.5 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (267) hide show
  1. package/CHANGELOG.md +112 -2
  2. package/dist/client/kiosk-client.d.mts +126 -0
  3. package/dist/client/kiosk-client.d.mts.map +1 -0
  4. package/dist/client/kiosk-client.mjs +124 -0
  5. package/dist/client/kiosk-client.mjs.map +1 -0
  6. package/dist/client/kiosk-transaction.d.mts +236 -0
  7. package/dist/client/kiosk-transaction.d.mts.map +1 -0
  8. package/dist/client/kiosk-transaction.mjs +472 -0
  9. package/dist/client/kiosk-transaction.mjs.map +1 -0
  10. package/dist/client/tp-transaction.d.mts +139 -0
  11. package/dist/client/tp-transaction.d.mts.map +1 -0
  12. package/dist/client/tp-transaction.mjs +273 -0
  13. package/dist/client/tp-transaction.mjs.map +1 -0
  14. package/dist/constants.d.mts +42 -0
  15. package/dist/constants.d.mts.map +1 -0
  16. package/dist/constants.mjs +62 -0
  17. package/dist/constants.mjs.map +1 -0
  18. package/dist/contracts/0x2/bag.mjs +19 -0
  19. package/dist/contracts/0x2/bag.mjs.map +1 -0
  20. package/dist/contracts/0x2/balance.mjs +20 -0
  21. package/dist/contracts/0x2/balance.mjs.map +1 -0
  22. package/dist/contracts/0x2/deps/0x0000000000000000000000000000000000000000000000000000000000000001/type_name.mjs +16 -0
  23. package/dist/contracts/0x2/deps/0x0000000000000000000000000000000000000000000000000000000000000001/type_name.mjs.map +1 -0
  24. package/dist/contracts/0x2/kiosk.mjs +244 -0
  25. package/dist/contracts/0x2/kiosk.mjs.map +1 -0
  26. package/dist/contracts/0x2/kiosk_extension.mjs +25 -0
  27. package/dist/contracts/0x2/kiosk_extension.mjs.map +1 -0
  28. package/dist/contracts/0x2/transfer_policy.mjs +99 -0
  29. package/dist/contracts/0x2/transfer_policy.mjs.map +1 -0
  30. package/dist/contracts/0x2/vec_set.mjs +18 -0
  31. package/dist/contracts/0x2/vec_set.mjs.map +1 -0
  32. package/dist/contracts/kiosk/deps/sui/kiosk.mjs +98 -0
  33. package/dist/contracts/kiosk/deps/sui/kiosk.mjs.map +1 -0
  34. package/dist/contracts/kiosk/floor_price_rule.mjs +70 -0
  35. package/dist/contracts/kiosk/floor_price_rule.mjs.map +1 -0
  36. package/dist/contracts/kiosk/kiosk_lock_rule.mjs +72 -0
  37. package/dist/contracts/kiosk/kiosk_lock_rule.mjs.map +1 -0
  38. package/dist/contracts/kiosk/personal_kiosk.mjs +102 -0
  39. package/dist/contracts/kiosk/personal_kiosk.mjs.map +1 -0
  40. package/dist/contracts/kiosk/personal_kiosk_rule.mjs +66 -0
  41. package/dist/contracts/kiosk/personal_kiosk_rule.mjs.map +1 -0
  42. package/dist/contracts/kiosk/royalty_rule.mjs +115 -0
  43. package/dist/contracts/kiosk/royalty_rule.mjs.map +1 -0
  44. package/dist/contracts/utils/index.mjs +118 -0
  45. package/dist/contracts/utils/index.mjs.map +1 -0
  46. package/dist/index.d.mts +9 -0
  47. package/dist/index.mjs +9 -0
  48. package/dist/query/client-utils.mjs +30 -0
  49. package/dist/query/client-utils.mjs.map +1 -0
  50. package/dist/query/kiosk.mjs +154 -0
  51. package/dist/query/kiosk.mjs.map +1 -0
  52. package/dist/query/transfer-policy.mjs +110 -0
  53. package/dist/query/transfer-policy.mjs.map +1 -0
  54. package/dist/tx/kiosk.mjs +20 -0
  55. package/dist/tx/kiosk.mjs.map +1 -0
  56. package/dist/tx/rules/resolve.mjs +114 -0
  57. package/dist/tx/rules/resolve.mjs.map +1 -0
  58. package/dist/tx/transfer-policy.mjs +38 -0
  59. package/dist/tx/transfer-policy.mjs.map +1 -0
  60. package/dist/types/index.d.mts +23 -0
  61. package/dist/types/index.d.mts.map +1 -0
  62. package/dist/types/kiosk.d.mts +165 -0
  63. package/dist/types/kiosk.d.mts.map +1 -0
  64. package/dist/types/kiosk.mjs +21 -0
  65. package/dist/types/kiosk.mjs.map +1 -0
  66. package/dist/types/transfer-policy.d.mts +56 -0
  67. package/dist/types/transfer-policy.d.mts.map +1 -0
  68. package/dist/types/transfer-policy.mjs +19 -0
  69. package/dist/types/transfer-policy.mjs.map +1 -0
  70. package/dist/utils.d.mts +45 -0
  71. package/dist/utils.d.mts.map +1 -0
  72. package/dist/utils.mjs +156 -0
  73. package/dist/utils.mjs.map +1 -0
  74. package/package.json +31 -20
  75. package/src/client/kiosk-client.ts +42 -5
  76. package/src/client/kiosk-transaction.ts +144 -65
  77. package/src/client/tp-transaction.ts +149 -95
  78. package/src/constants.ts +19 -24
  79. package/src/contracts/0x2/accumulator.ts +24 -0
  80. package/src/contracts/0x2/accumulator_metadata.ts +38 -0
  81. package/src/contracts/0x2/accumulator_settlement.ts +14 -0
  82. package/src/contracts/0x2/address.ts +145 -0
  83. package/src/contracts/0x2/address_alias.ts +92 -0
  84. package/src/contracts/0x2/authenticator_state.ts +44 -0
  85. package/src/contracts/0x2/bag.ts +192 -0
  86. package/src/contracts/0x2/balance.ts +269 -0
  87. package/src/contracts/0x2/bcs.ts +495 -0
  88. package/src/contracts/0x2/bls12381.ts +717 -0
  89. package/src/contracts/0x2/borrow.ts +99 -0
  90. package/src/contracts/0x2/clock.ts +30 -0
  91. package/src/contracts/0x2/coin.ts +977 -0
  92. package/src/contracts/0x2/coin_registry.ts +874 -0
  93. package/src/contracts/0x2/config.ts +30 -0
  94. package/src/contracts/0x2/deny_list.ts +55 -0
  95. package/src/contracts/0x2/deps/0x0000000000000000000000000000000000000000000000000000000000000001/type_name.ts +12 -0
  96. package/src/contracts/0x2/derived_object.ts +95 -0
  97. package/src/contracts/0x2/display.ts +258 -0
  98. package/src/contracts/0x2/dynamic_field.ts +171 -0
  99. package/src/contracts/0x2/dynamic_object_field.ts +167 -0
  100. package/src/contracts/0x2/ecdsa_k1.ts +65 -0
  101. package/src/contracts/0x2/ecdsa_r1.ts +49 -0
  102. package/src/contracts/0x2/ecvrf.ts +29 -0
  103. package/src/contracts/0x2/ed25519.ts +25 -0
  104. package/src/contracts/0x2/event.ts +42 -0
  105. package/src/contracts/0x2/funds_accumulator.ts +86 -0
  106. package/src/contracts/0x2/groth16.ts +171 -0
  107. package/src/contracts/0x2/group_ops.ts +49 -0
  108. package/src/contracts/0x2/hash.ts +37 -0
  109. package/src/contracts/0x2/hex.ts +37 -0
  110. package/src/contracts/0x2/hmac.ts +21 -0
  111. package/src/contracts/0x2/kiosk.ts +797 -0
  112. package/src/contracts/0x2/kiosk_extension.ts +270 -0
  113. package/src/contracts/0x2/linked_table.ts +354 -0
  114. package/src/contracts/0x2/math.ts +117 -0
  115. package/src/contracts/0x2/nitro_attestation.ts +186 -0
  116. package/src/contracts/0x2/object.ts +249 -0
  117. package/src/contracts/0x2/object_bag.ts +210 -0
  118. package/src/contracts/0x2/object_table.ts +200 -0
  119. package/src/contracts/0x2/package.ts +414 -0
  120. package/src/contracts/0x2/party.ts +37 -0
  121. package/src/contracts/0x2/pay.ts +153 -0
  122. package/src/contracts/0x2/poseidon.ts +21 -0
  123. package/src/contracts/0x2/priority_queue.ts +139 -0
  124. package/src/contracts/0x2/random.ts +294 -0
  125. package/src/contracts/0x2/sui.ts +29 -0
  126. package/src/contracts/0x2/table.ts +200 -0
  127. package/src/contracts/0x2/table_vec.ts +232 -0
  128. package/src/contracts/0x2/token.ts +873 -0
  129. package/src/contracts/0x2/transfer.ts +216 -0
  130. package/src/contracts/0x2/transfer_policy.ts +400 -0
  131. package/src/contracts/0x2/tx_context.ts +129 -0
  132. package/src/contracts/0x2/types.ts +24 -0
  133. package/src/contracts/0x2/url.ts +77 -0
  134. package/src/contracts/0x2/vdf.ts +45 -0
  135. package/src/contracts/0x2/vec_map.ts +401 -0
  136. package/src/contracts/0x2/vec_set.ts +211 -0
  137. package/src/contracts/0x2/versioned.ts +153 -0
  138. package/src/contracts/0x2/zklogin_verified_id.ts +172 -0
  139. package/src/contracts/0x2/zklogin_verified_issuer.ts +99 -0
  140. package/src/contracts/kiosk/deps/sui/kiosk.ts +94 -0
  141. package/src/contracts/kiosk/deps/sui/object.ts +15 -0
  142. package/src/contracts/kiosk/floor_price_rule.ts +92 -0
  143. package/src/contracts/kiosk/kiosk_lock_rule.ts +97 -0
  144. package/src/contracts/kiosk/personal_kiosk.ts +295 -0
  145. package/src/contracts/kiosk/personal_kiosk_rule.ts +89 -0
  146. package/src/contracts/kiosk/royalty_rule.ts +144 -0
  147. package/src/contracts/kiosk/witness_rule.ts +92 -0
  148. package/src/contracts/utils/index.ts +234 -0
  149. package/src/query/client-utils.ts +51 -0
  150. package/src/query/kiosk.ts +128 -100
  151. package/src/query/transfer-policy.ts +112 -78
  152. package/src/tx/kiosk.ts +7 -231
  153. package/src/tx/rules/resolve.ts +97 -48
  154. package/src/tx/transfer-policy.ts +25 -86
  155. package/src/types/index.ts +3 -14
  156. package/src/types/kiosk.ts +10 -12
  157. package/src/types/transfer-policy.ts +4 -4
  158. package/src/utils.ts +90 -128
  159. package/dist/cjs/bcs.d.ts +0 -23
  160. package/dist/cjs/bcs.js +0 -50
  161. package/dist/cjs/bcs.js.map +0 -7
  162. package/dist/cjs/client/kiosk-client.d.ts +0 -76
  163. package/dist/cjs/client/kiosk-client.js +0 -123
  164. package/dist/cjs/client/kiosk-client.js.map +0 -7
  165. package/dist/cjs/client/kiosk-transaction.d.ts +0 -186
  166. package/dist/cjs/client/kiosk-transaction.js +0 -462
  167. package/dist/cjs/client/kiosk-transaction.js.map +0 -7
  168. package/dist/cjs/client/tp-transaction.d.ts +0 -114
  169. package/dist/cjs/client/tp-transaction.js +0 -307
  170. package/dist/cjs/client/tp-transaction.js.map +0 -7
  171. package/dist/cjs/constants.d.ts +0 -31
  172. package/dist/cjs/constants.js +0 -102
  173. package/dist/cjs/constants.js.map +0 -7
  174. package/dist/cjs/index.d.ts +0 -6
  175. package/dist/cjs/index.js +0 -24
  176. package/dist/cjs/index.js.map +0 -7
  177. package/dist/cjs/package.json +0 -5
  178. package/dist/cjs/query/kiosk.d.ts +0 -8
  179. package/dist/cjs/query/kiosk.js +0 -181
  180. package/dist/cjs/query/kiosk.js.map +0 -7
  181. package/dist/cjs/query/transfer-policy.d.ts +0 -29
  182. package/dist/cjs/query/transfer-policy.js +0 -92
  183. package/dist/cjs/query/transfer-policy.js.map +0 -7
  184. package/dist/cjs/tx/kiosk.d.ts +0 -71
  185. package/dist/cjs/tx/kiosk.js +0 -130
  186. package/dist/cjs/tx/kiosk.js.map +0 -7
  187. package/dist/cjs/tx/personal-kiosk.d.ts +0 -7
  188. package/dist/cjs/tx/personal-kiosk.js +0 -38
  189. package/dist/cjs/tx/personal-kiosk.js.map +0 -7
  190. package/dist/cjs/tx/rules/attach.d.ts +0 -7
  191. package/dist/cjs/tx/rules/attach.js +0 -62
  192. package/dist/cjs/tx/rules/attach.js.map +0 -7
  193. package/dist/cjs/tx/rules/resolve.d.ts +0 -15
  194. package/dist/cjs/tx/rules/resolve.js +0 -109
  195. package/dist/cjs/tx/rules/resolve.js.map +0 -7
  196. package/dist/cjs/tx/transfer-policy.d.ts +0 -29
  197. package/dist/cjs/tx/transfer-policy.js +0 -78
  198. package/dist/cjs/tx/transfer-policy.js.map +0 -7
  199. package/dist/cjs/types/index.d.ts +0 -27
  200. package/dist/cjs/types/index.js +0 -33
  201. package/dist/cjs/types/index.js.map +0 -7
  202. package/dist/cjs/types/kiosk.d.ts +0 -160
  203. package/dist/cjs/types/kiosk.js +0 -37
  204. package/dist/cjs/types/kiosk.js.map +0 -7
  205. package/dist/cjs/types/transfer-policy.d.ts +0 -53
  206. package/dist/cjs/types/transfer-policy.js +0 -35
  207. package/dist/cjs/types/transfer-policy.js.map +0 -7
  208. package/dist/cjs/utils.d.ts +0 -51
  209. package/dist/cjs/utils.js +0 -198
  210. package/dist/cjs/utils.js.map +0 -7
  211. package/dist/esm/bcs.d.ts +0 -23
  212. package/dist/esm/bcs.js +0 -35
  213. package/dist/esm/bcs.js.map +0 -7
  214. package/dist/esm/client/kiosk-client.d.ts +0 -76
  215. package/dist/esm/client/kiosk-client.js +0 -114
  216. package/dist/esm/client/kiosk-client.js.map +0 -7
  217. package/dist/esm/client/kiosk-transaction.d.ts +0 -186
  218. package/dist/esm/client/kiosk-transaction.js +0 -432
  219. package/dist/esm/client/kiosk-transaction.js.map +0 -7
  220. package/dist/esm/client/tp-transaction.d.ts +0 -114
  221. package/dist/esm/client/tp-transaction.js +0 -298
  222. package/dist/esm/client/tp-transaction.js.map +0 -7
  223. package/dist/esm/constants.d.ts +0 -31
  224. package/dist/esm/constants.js +0 -87
  225. package/dist/esm/constants.js.map +0 -7
  226. package/dist/esm/index.d.ts +0 -6
  227. package/dist/esm/index.js +0 -7
  228. package/dist/esm/index.js.map +0 -7
  229. package/dist/esm/package.json +0 -5
  230. package/dist/esm/query/kiosk.d.ts +0 -8
  231. package/dist/esm/query/kiosk.js +0 -169
  232. package/dist/esm/query/kiosk.js.map +0 -7
  233. package/dist/esm/query/transfer-policy.d.ts +0 -29
  234. package/dist/esm/query/transfer-policy.js +0 -76
  235. package/dist/esm/query/transfer-policy.js.map +0 -7
  236. package/dist/esm/tx/kiosk.d.ts +0 -71
  237. package/dist/esm/tx/kiosk.js +0 -110
  238. package/dist/esm/tx/kiosk.js.map +0 -7
  239. package/dist/esm/tx/personal-kiosk.d.ts +0 -7
  240. package/dist/esm/tx/personal-kiosk.js +0 -18
  241. package/dist/esm/tx/personal-kiosk.js.map +0 -7
  242. package/dist/esm/tx/rules/attach.d.ts +0 -7
  243. package/dist/esm/tx/rules/attach.js +0 -42
  244. package/dist/esm/tx/rules/attach.js.map +0 -7
  245. package/dist/esm/tx/rules/resolve.d.ts +0 -15
  246. package/dist/esm/tx/rules/resolve.js +0 -89
  247. package/dist/esm/tx/rules/resolve.js.map +0 -7
  248. package/dist/esm/tx/transfer-policy.d.ts +0 -29
  249. package/dist/esm/tx/transfer-policy.js +0 -58
  250. package/dist/esm/tx/transfer-policy.js.map +0 -7
  251. package/dist/esm/types/index.d.ts +0 -27
  252. package/dist/esm/types/index.js +0 -12
  253. package/dist/esm/types/index.js.map +0 -7
  254. package/dist/esm/types/kiosk.d.ts +0 -160
  255. package/dist/esm/types/kiosk.js +0 -17
  256. package/dist/esm/types/kiosk.js.map +0 -7
  257. package/dist/esm/types/transfer-policy.d.ts +0 -53
  258. package/dist/esm/types/transfer-policy.js +0 -15
  259. package/dist/esm/types/transfer-policy.js.map +0 -7
  260. package/dist/esm/utils.d.ts +0 -51
  261. package/dist/esm/utils.js +0 -183
  262. package/dist/esm/utils.js.map +0 -7
  263. package/dist/tsconfig.esm.tsbuildinfo +0 -1
  264. package/dist/tsconfig.tsbuildinfo +0 -1
  265. package/src/bcs.ts +0 -39
  266. package/src/tx/personal-kiosk.ts +0 -34
  267. package/src/tx/rules/attach.ts +0 -73
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../src/bcs.ts"],
4
- "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { bcs } from '@mysten/sui/bcs';\n\nimport {\n\tKIOSK_PURCHASE_CAP,\n\tKIOSK_TYPE,\n\tTRANSFER_POLICY_CREATED_EVENT,\n\tTRANSFER_POLICY_TYPE,\n} from './types/index.js';\n\n// Register the `Kiosk` struct for faster queries.\nexport const KioskType = bcs.struct(KIOSK_TYPE, {\n\tid: bcs.Address,\n\tprofits: bcs.u64(),\n\towner: bcs.Address,\n\titemCount: bcs.u32(),\n\tallowExtensions: bcs.bool(),\n});\n\n// Register the `PurchaseCap` for faster queries.\nexport const KioskPurchaseCap = bcs.struct(KIOSK_PURCHASE_CAP, {\n\tid: bcs.Address,\n\tkioskId: bcs.Address,\n\titemId: bcs.Address,\n\tminPrice: bcs.u64(),\n});\n\n// Register the `TransferPolicyCreated` event data.\nexport const TransferPolicyCreatedEvent = bcs.struct(TRANSFER_POLICY_CREATED_EVENT, {\n\tid: bcs.Address,\n});\n\nexport const TransferPolicyType = bcs.struct(TRANSFER_POLICY_TYPE, {\n\tid: bcs.Address,\n\tbalance: bcs.u64(),\n\trules: bcs.vector(bcs.string()),\n});\n"],
5
- "mappings": "AAGA,SAAS,WAAW;AAEpB;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AAGA,MAAM,YAAY,IAAI,OAAO,YAAY;AAAA,EAC/C,IAAI,IAAI;AAAA,EACR,SAAS,IAAI,IAAI;AAAA,EACjB,OAAO,IAAI;AAAA,EACX,WAAW,IAAI,IAAI;AAAA,EACnB,iBAAiB,IAAI,KAAK;AAC3B,CAAC;AAGM,MAAM,mBAAmB,IAAI,OAAO,oBAAoB;AAAA,EAC9D,IAAI,IAAI;AAAA,EACR,SAAS,IAAI;AAAA,EACb,QAAQ,IAAI;AAAA,EACZ,UAAU,IAAI,IAAI;AACnB,CAAC;AAGM,MAAM,6BAA6B,IAAI,OAAO,+BAA+B;AAAA,EACnF,IAAI,IAAI;AACT,CAAC;AAEM,MAAM,qBAAqB,IAAI,OAAO,sBAAsB;AAAA,EAClE,IAAI,IAAI;AAAA,EACR,SAAS,IAAI,IAAI;AAAA,EACjB,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC;AAC/B,CAAC;",
6
- "names": []
7
- }
@@ -1,76 +0,0 @@
1
- import type { PaginationArguments, SuiClient } from '@mysten/sui/client';
2
- import type { BaseRulePackageIds, TransferPolicyRule } from '../constants.js';
3
- import { Network } from '../types/index.js';
4
- import type { FetchKioskOptions, KioskClientOptions, KioskData, OwnedKiosks } from '../types/index.js';
5
- /**
6
- * A Client that allows you to interact with kiosk.
7
- * Offers utilities to query kiosk, craft transactions to edit your own kiosk,
8
- * purchase, manage transfer policies, create new kiosks etc.
9
- * If you pass packageIds, all functionality will be managed using these packages.
10
- */
11
- export declare class KioskClient {
12
- client: SuiClient;
13
- network: Network;
14
- rules: TransferPolicyRule[];
15
- packageIds?: BaseRulePackageIds;
16
- constructor(options: KioskClientOptions);
17
- /**
18
- * Get an addresses's owned kiosks.
19
- * @param address The address for which we want to retrieve the kiosks.
20
- * @param pagination Optional pagination arguments.
21
- * @returns An Object containing all the `kioskOwnerCap` objects as well as the kioskIds.
22
- */
23
- getOwnedKiosks({ address, pagination, }: {
24
- address: string;
25
- pagination?: PaginationArguments<string>;
26
- }): Promise<OwnedKiosks>;
27
- /**
28
- * Fetches the kiosk contents.
29
- * @param id The ID of the kiosk to fetch.
30
- * @param options Optional to control the fetch behavior.
31
- * @returns
32
- */
33
- getKiosk({ id, options }: {
34
- id: string;
35
- options?: FetchKioskOptions;
36
- }): Promise<KioskData>;
37
- /**
38
- * Fetch the extension data (if any) for a kiosk, by type
39
- * @param kioskId The ID of the kiosk to lookup
40
- * @param extensionType The Type of the extension (can be used from by using the type returned by `getKiosk()`)
41
- */
42
- getKioskExtension({ kioskId, type }: {
43
- kioskId: string;
44
- type: string;
45
- }): Promise<import("../types/kiosk.js").KioskExtension | null>;
46
- /**
47
- * Query the Transfer Policy(ies) for type `T`.
48
- * @param type The Type we're querying for (E.g `0xMyAddress::hero::Hero`)
49
- */
50
- getTransferPolicies({ type }: {
51
- type: string;
52
- }): Promise<import("../types/transfer-policy.js").TransferPolicy[]>;
53
- /**
54
- * Query all the owned transfer policies for an address.
55
- * Returns `TransferPolicyCap` which uncludes `policyId, policyCapId, type`.
56
- * @param address The address we're searching the owned transfer policies for.
57
- */
58
- getOwnedTransferPolicies({ address }: {
59
- address: string;
60
- }): Promise<import("../types/transfer-policy.js").TransferPolicyCap[] | undefined>;
61
- /**
62
- * Query the Transfer Policy Cap for type `T`, owned by `address`
63
- * @param type The Type `T` for the object
64
- * @param address The address that owns the cap.
65
- */
66
- getOwnedTransferPoliciesByType({ type, address }: {
67
- type: string;
68
- address: string;
69
- }): Promise<import("../types/transfer-policy.js").TransferPolicyCap[]>;
70
- addRuleResolver(rule: TransferPolicyRule): void;
71
- /**
72
- * A convenient helper to get the packageIds for our supported ruleset,
73
- * based on `kioskClient` configuration.
74
- */
75
- getRulePackageId(rule: 'kioskLockRulePackageId' | 'royaltyRulePackageId' | 'personalKioskRulePackageId' | 'floorPriceRulePackageId'): string;
76
- }
@@ -1,114 +0,0 @@
1
- import {
2
- FLOOR_PRICE_RULE_ADDRESS,
3
- getBaseRules,
4
- KIOSK_LOCK_RULE_ADDRESS,
5
- PERSONAL_KIOSK_RULE_ADDRESS,
6
- ROYALTY_RULE_ADDRESS,
7
- rules
8
- } from "../constants.js";
9
- import { fetchKiosk, fetchKioskExtension, getOwnedKiosks } from "../query/kiosk.js";
10
- import {
11
- queryOwnedTransferPolicies,
12
- queryTransferPolicy,
13
- queryTransferPolicyCapsByType
14
- } from "../query/transfer-policy.js";
15
- import { Network } from "../types/index.js";
16
- class KioskClient {
17
- constructor(options) {
18
- this.client = options.client;
19
- this.network = options.network;
20
- this.rules = rules;
21
- this.packageIds = options.packageIds;
22
- if (options.packageIds) this.rules.push(...getBaseRules(options.packageIds));
23
- }
24
- /// Querying
25
- /**
26
- * Get an addresses's owned kiosks.
27
- * @param address The address for which we want to retrieve the kiosks.
28
- * @param pagination Optional pagination arguments.
29
- * @returns An Object containing all the `kioskOwnerCap` objects as well as the kioskIds.
30
- */
31
- async getOwnedKiosks({
32
- address,
33
- pagination
34
- }) {
35
- const personalPackageId = this.packageIds?.personalKioskRulePackageId || PERSONAL_KIOSK_RULE_ADDRESS[this.network];
36
- return getOwnedKiosks(this.client, address, {
37
- pagination,
38
- personalKioskType: personalPackageId ? `${personalPackageId}::personal_kiosk::PersonalKioskCap` : ""
39
- });
40
- }
41
- /**
42
- * Fetches the kiosk contents.
43
- * @param id The ID of the kiosk to fetch.
44
- * @param options Optional to control the fetch behavior.
45
- * @returns
46
- */
47
- async getKiosk({ id, options }) {
48
- return (await fetchKiosk(this.client, id, {}, options || {})).data;
49
- }
50
- /**
51
- * Fetch the extension data (if any) for a kiosk, by type
52
- * @param kioskId The ID of the kiosk to lookup
53
- * @param extensionType The Type of the extension (can be used from by using the type returned by `getKiosk()`)
54
- */
55
- async getKioskExtension({ kioskId, type }) {
56
- return fetchKioskExtension(this.client, kioskId, type);
57
- }
58
- /**
59
- * Query the Transfer Policy(ies) for type `T`.
60
- * @param type The Type we're querying for (E.g `0xMyAddress::hero::Hero`)
61
- */
62
- async getTransferPolicies({ type }) {
63
- return queryTransferPolicy(this.client, type);
64
- }
65
- /**
66
- * Query all the owned transfer policies for an address.
67
- * Returns `TransferPolicyCap` which uncludes `policyId, policyCapId, type`.
68
- * @param address The address we're searching the owned transfer policies for.
69
- */
70
- async getOwnedTransferPolicies({ address }) {
71
- return queryOwnedTransferPolicies(this.client, address);
72
- }
73
- /**
74
- * Query the Transfer Policy Cap for type `T`, owned by `address`
75
- * @param type The Type `T` for the object
76
- * @param address The address that owns the cap.
77
- */
78
- async getOwnedTransferPoliciesByType({ type, address }) {
79
- return queryTransferPolicyCapsByType(this.client, address, type);
80
- }
81
- // Someone would just have to create a `kiosk-client.ts` file in their project, initialize a KioskClient
82
- // and call the `addRuleResolver` function. Each rule has a `resolve` function.
83
- // The resolve function is automatically called on `purchaseAndResolve` function call.
84
- addRuleResolver(rule) {
85
- if (this.rules.find((x) => x.rule === rule.rule))
86
- throw new Error(`Rule ${rule.rule} resolver already exists.`);
87
- this.rules.push(rule);
88
- }
89
- /**
90
- * A convenient helper to get the packageIds for our supported ruleset,
91
- * based on `kioskClient` configuration.
92
- */
93
- getRulePackageId(rule) {
94
- const rules2 = this.packageIds || {};
95
- const network = this.network;
96
- if (!rules2[rule] && network !== Network.MAINNET && network !== Network.TESTNET) {
97
- throw new Error(`Missing packageId for rule ${rule}`);
98
- }
99
- switch (rule) {
100
- case "kioskLockRulePackageId":
101
- return rules2[rule] || KIOSK_LOCK_RULE_ADDRESS[network];
102
- case "royaltyRulePackageId":
103
- return rules2[rule] || ROYALTY_RULE_ADDRESS[network];
104
- case "personalKioskRulePackageId":
105
- return rules2[rule] || PERSONAL_KIOSK_RULE_ADDRESS[network];
106
- case "floorPriceRulePackageId":
107
- return rules2[rule] || FLOOR_PRICE_RULE_ADDRESS[network];
108
- }
109
- }
110
- }
111
- export {
112
- KioskClient
113
- };
114
- //# sourceMappingURL=kiosk-client.js.map
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../../src/client/kiosk-client.ts"],
4
- "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { PaginationArguments, SuiClient } from '@mysten/sui/client';\n\nimport {\n\tFLOOR_PRICE_RULE_ADDRESS,\n\tgetBaseRules,\n\tKIOSK_LOCK_RULE_ADDRESS,\n\tPERSONAL_KIOSK_RULE_ADDRESS,\n\tROYALTY_RULE_ADDRESS,\n\trules,\n} from '../constants.js';\nimport type { BaseRulePackageIds, TransferPolicyRule } from '../constants.js';\nimport { fetchKiosk, fetchKioskExtension, getOwnedKiosks } from '../query/kiosk.js';\nimport {\n\tqueryOwnedTransferPolicies,\n\tqueryTransferPolicy,\n\tqueryTransferPolicyCapsByType,\n} from '../query/transfer-policy.js';\nimport { Network } from '../types/index.js';\nimport type {\n\tFetchKioskOptions,\n\tKioskClientOptions,\n\tKioskData,\n\tOwnedKiosks,\n} from '../types/index.js';\n\n/**\n * A Client that allows you to interact with kiosk.\n * Offers utilities to query kiosk, craft transactions to edit your own kiosk,\n * purchase, manage transfer policies, create new kiosks etc.\n * If you pass packageIds, all functionality will be managed using these packages.\n */\nexport class KioskClient {\n\tclient: SuiClient;\n\tnetwork: Network;\n\trules: TransferPolicyRule[];\n\tpackageIds?: BaseRulePackageIds;\n\n\tconstructor(options: KioskClientOptions) {\n\t\tthis.client = options.client;\n\t\tthis.network = options.network;\n\t\tthis.rules = rules; // add all the default rules.\n\t\tthis.packageIds = options.packageIds;\n\n\t\t// Add the custom Package Ids too on the rule list.\n\t\t// Only adds the rules that are passed in the packageId object.\n\t\tif (options.packageIds) this.rules.push(...getBaseRules(options.packageIds));\n\t}\n\n\t/// Querying\n\n\t/**\n\t * Get an addresses's owned kiosks.\n\t * @param address The address for which we want to retrieve the kiosks.\n\t * @param pagination Optional pagination arguments.\n\t * @returns An Object containing all the `kioskOwnerCap` objects as well as the kioskIds.\n\t */\n\tasync getOwnedKiosks({\n\t\taddress,\n\t\tpagination,\n\t}: {\n\t\taddress: string;\n\t\tpagination?: PaginationArguments<string>;\n\t}): Promise<OwnedKiosks> {\n\t\tconst personalPackageId =\n\t\t\tthis.packageIds?.personalKioskRulePackageId || PERSONAL_KIOSK_RULE_ADDRESS[this.network];\n\n\t\treturn getOwnedKiosks(this.client, address, {\n\t\t\tpagination,\n\t\t\tpersonalKioskType: personalPackageId\n\t\t\t\t? `${personalPackageId}::personal_kiosk::PersonalKioskCap`\n\t\t\t\t: '',\n\t\t});\n\t}\n\n\t/**\n\t * Fetches the kiosk contents.\n\t * @param id The ID of the kiosk to fetch.\n\t * @param options Optional to control the fetch behavior.\n\t * @returns\n\t */\n\tasync getKiosk({ id, options }: { id: string; options?: FetchKioskOptions }): Promise<KioskData> {\n\t\treturn (await fetchKiosk(this.client, id, {}, options || {})).data;\n\t}\n\n\t/**\n\t * Fetch the extension data (if any) for a kiosk, by type\n\t * @param kioskId The ID of the kiosk to lookup\n\t * @param extensionType The Type of the extension (can be used from by using the type returned by `getKiosk()`)\n\t */\n\tasync getKioskExtension({ kioskId, type }: { kioskId: string; type: string }) {\n\t\treturn fetchKioskExtension(this.client, kioskId, type);\n\t}\n\n\t/**\n\t * Query the Transfer Policy(ies) for type `T`.\n\t * @param type The Type we're querying for (E.g `0xMyAddress::hero::Hero`)\n\t */\n\tasync getTransferPolicies({ type }: { type: string }) {\n\t\treturn queryTransferPolicy(this.client, type);\n\t}\n\n\t/**\n\t * Query all the owned transfer policies for an address.\n\t * Returns `TransferPolicyCap` which uncludes `policyId, policyCapId, type`.\n\t * @param address The address we're searching the owned transfer policies for.\n\t */\n\tasync getOwnedTransferPolicies({ address }: { address: string }) {\n\t\treturn queryOwnedTransferPolicies(this.client, address);\n\t}\n\n\t/**\n\t * Query the Transfer Policy Cap for type `T`, owned by `address`\n\t * @param type The Type `T` for the object\n\t * @param address The address that owns the cap.\n\t */\n\tasync getOwnedTransferPoliciesByType({ type, address }: { type: string; address: string }) {\n\t\treturn queryTransferPolicyCapsByType(this.client, address, type);\n\t}\n\n\t// Someone would just have to create a `kiosk-client.ts` file in their project, initialize a KioskClient\n\t// and call the `addRuleResolver` function. Each rule has a `resolve` function.\n\t// The resolve function is automatically called on `purchaseAndResolve` function call.\n\taddRuleResolver(rule: TransferPolicyRule) {\n\t\tif (this.rules.find((x) => x.rule === rule.rule))\n\t\t\tthrow new Error(`Rule ${rule.rule} resolver already exists.`);\n\t\tthis.rules.push(rule);\n\t}\n\n\t/**\n\t * A convenient helper to get the packageIds for our supported ruleset,\n\t * based on `kioskClient` configuration.\n\t */\n\tgetRulePackageId(\n\t\trule:\n\t\t\t| 'kioskLockRulePackageId'\n\t\t\t| 'royaltyRulePackageId'\n\t\t\t| 'personalKioskRulePackageId'\n\t\t\t| 'floorPriceRulePackageId',\n\t) {\n\t\tconst rules = this.packageIds || {};\n\t\tconst network = this.network;\n\n\t\t/// Check existence of rule based on network and throw an error if it's not found.\n\t\t/// We always have a fallback for testnet or mainnet.\n\t\tif (!rules[rule] && network !== Network.MAINNET && network !== Network.TESTNET) {\n\t\t\tthrow new Error(`Missing packageId for rule ${rule}`);\n\t\t}\n\n\t\tswitch (rule) {\n\t\t\tcase 'kioskLockRulePackageId':\n\t\t\t\treturn rules[rule] || KIOSK_LOCK_RULE_ADDRESS[network];\n\t\t\tcase 'royaltyRulePackageId':\n\t\t\t\treturn rules[rule] || ROYALTY_RULE_ADDRESS[network];\n\t\t\tcase 'personalKioskRulePackageId':\n\t\t\t\treturn rules[rule] || PERSONAL_KIOSK_RULE_ADDRESS[network];\n\t\t\tcase 'floorPriceRulePackageId':\n\t\t\t\treturn rules[rule] || FLOOR_PRICE_RULE_ADDRESS[network];\n\t\t}\n\t}\n}\n"],
5
- "mappings": "AAKA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AAEP,SAAS,YAAY,qBAAqB,sBAAsB;AAChE;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,SAAS,eAAe;AAcjB,MAAM,YAAY;AAAA,EAMxB,YAAY,SAA6B;AACxC,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ;AACvB,SAAK,QAAQ;AACb,SAAK,aAAa,QAAQ;AAI1B,QAAI,QAAQ,WAAY,MAAK,MAAM,KAAK,GAAG,aAAa,QAAQ,UAAU,CAAC;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eAAe;AAAA,IACpB;AAAA,IACA;AAAA,EACD,GAGyB;AACxB,UAAM,oBACL,KAAK,YAAY,8BAA8B,4BAA4B,KAAK,OAAO;AAExF,WAAO,eAAe,KAAK,QAAQ,SAAS;AAAA,MAC3C;AAAA,MACA,mBAAmB,oBAChB,GAAG,iBAAiB,uCACpB;AAAA,IACJ,CAAC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,SAAS,EAAE,IAAI,QAAQ,GAAoE;AAChG,YAAQ,MAAM,WAAW,KAAK,QAAQ,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,kBAAkB,EAAE,SAAS,KAAK,GAAsC;AAC7E,WAAO,oBAAoB,KAAK,QAAQ,SAAS,IAAI;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,oBAAoB,EAAE,KAAK,GAAqB;AACrD,WAAO,oBAAoB,KAAK,QAAQ,IAAI;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,yBAAyB,EAAE,QAAQ,GAAwB;AAChE,WAAO,2BAA2B,KAAK,QAAQ,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,+BAA+B,EAAE,MAAM,QAAQ,GAAsC;AAC1F,WAAO,8BAA8B,KAAK,QAAQ,SAAS,IAAI;AAAA,EAChE;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,MAA0B;AACzC,QAAI,KAAK,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI;AAC9C,YAAM,IAAI,MAAM,QAAQ,KAAK,IAAI,2BAA2B;AAC7D,SAAK,MAAM,KAAK,IAAI;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBACC,MAKC;AACD,UAAMA,SAAQ,KAAK,cAAc,CAAC;AAClC,UAAM,UAAU,KAAK;AAIrB,QAAI,CAACA,OAAM,IAAI,KAAK,YAAY,QAAQ,WAAW,YAAY,QAAQ,SAAS;AAC/E,YAAM,IAAI,MAAM,8BAA8B,IAAI,EAAE;AAAA,IACrD;AAEA,YAAQ,MAAM;AAAA,MACb,KAAK;AACJ,eAAOA,OAAM,IAAI,KAAK,wBAAwB,OAAO;AAAA,MACtD,KAAK;AACJ,eAAOA,OAAM,IAAI,KAAK,qBAAqB,OAAO;AAAA,MACnD,KAAK;AACJ,eAAOA,OAAM,IAAI,KAAK,4BAA4B,OAAO;AAAA,MAC1D,KAAK;AACJ,eAAOA,OAAM,IAAI,KAAK,yBAAyB,OAAO;AAAA,IACxD;AAAA,EACD;AACD;",
6
- "names": ["rules"]
7
- }
@@ -1,186 +0,0 @@
1
- import type { Transaction, TransactionArgument, TransactionObjectArgument } from '@mysten/sui/transactions';
2
- import type { ItemId, ItemReference, ItemValue, KioskOwnerCap, ObjectArgument, Price, PurchaseOptions } from '../types/index.js';
3
- import type { KioskClient } from './kiosk-client.js';
4
- export type KioskTransactionParams = {
5
- /** The Transaction for this run */
6
- transaction: Transaction;
7
- /** @deprecated use transaction instead */
8
- transactionBlock?: Transaction;
9
- /**
10
- * You can create a new KioskClient by calling `new KioskClient()`
11
- */
12
- kioskClient: KioskClient;
13
- /**
14
- * You can optionally pass in the `cap` as returned
15
- * from `kioskClient.getOwnedKiosks` when initializing the client
16
- * Otherwise, you can set it by calling `kioskTransaction.setCap()`
17
- */
18
- cap?: KioskOwnerCap;
19
- };
20
- /**
21
- * A helper for building transactions that involve kiosk.
22
- */
23
- export declare class KioskTransaction {
24
- #private;
25
- transaction: Transaction;
26
- kioskClient: KioskClient;
27
- kiosk?: TransactionObjectArgument;
28
- kioskCap?: TransactionObjectArgument;
29
- constructor({ transactionBlock, transaction, kioskClient, cap, }: KioskTransactionParams);
30
- /**
31
- * Creates a kiosk and saves `kiosk` and `kioskOwnerCap` in state.
32
- * Helpful if we want to chain some actions before sharing + transferring the cap to the specified address.
33
- * @param borrow If true, the `kioskOwnerCap` is borrowed from the `PersonalKioskCap` to be used in next transactions.
34
- */
35
- create(): this;
36
- /**
37
- * Creates a personal kiosk & shares it.
38
- * The `PersonalKioskCap` is transferred to the signer.
39
- * @param borrow If true, the `kioskOwnerCap` is borrowed from the `PersonalKioskCap` to be used in next transactions.
40
- */
41
- createPersonal(borrow?: boolean): this;
42
- /**
43
- * Converts a kiosk to a Personal (Soulbound) Kiosk.
44
- * Requires initialization by either calling `ktxb.create()` or `ktxb.setCap()`.
45
- */
46
- convertToPersonal(borrow?: boolean): this;
47
- /**
48
- * Single function way to create a kiosk, share it and transfer the cap to the specified address.
49
- */
50
- createAndShare(address: string): this;
51
- /**
52
- * Shares the kiosk.
53
- */
54
- share(): this;
55
- /**
56
- * Should be called only after `create` is called.
57
- * It shares the kiosk & transfers the cap to the specified address.
58
- */
59
- shareAndTransferCap(address: string): this;
60
- /**
61
- * A function to borrow an item from a kiosk & execute any function with it.
62
- * Example: You could borrow a Fren out of a kiosk, attach an accessory (or mix), and return it.
63
- */
64
- borrowTx({ itemType, itemId }: ItemId, callback: (item: TransactionArgument) => void): this;
65
- /**
66
- * Borrows an item from the kiosk.
67
- * This will fail if the item is listed for sale.
68
- *
69
- * Requires calling `return`.
70
- */
71
- borrow({ itemType, itemId }: ItemId): [TransactionArgument, TransactionArgument];
72
- /**
73
- * Returns the item back to the kiosk.
74
- * Accepts the parameters returned from the `borrow` function.
75
- */
76
- return({ itemType, item, promise }: ItemValue & {
77
- promise: TransactionArgument;
78
- }): this;
79
- /**
80
- * A function to withdraw from kiosk
81
- * @param address Where to trasnfer the coin.
82
- * @param amount The amount we aim to withdraw.
83
- */
84
- withdraw(address: string, amount?: string | bigint | number): this;
85
- /**
86
- * A function to place an item in the kiosk.
87
- * @param itemType The type `T` of the item
88
- * @param item The ID or Transaction Argument of the item
89
- */
90
- place({ itemType, item }: ItemReference): this;
91
- /**
92
- * A function to place an item in the kiosk and list it for sale in one transaction.
93
- * @param itemType The type `T` of the item
94
- * @param item The ID or Transaction Argument of the item
95
- * @param price The price in MIST
96
- */
97
- placeAndList({ itemType, item, price }: ItemReference & Price): this;
98
- /**
99
- * A function to list an item in the kiosk.
100
- * @param itemType The type `T` of the item
101
- * @param itemId The ID of the item
102
- * @param price The price in MIST
103
- */
104
- list({ itemType, itemId, price }: ItemId & {
105
- price: string | bigint;
106
- }): this;
107
- /**
108
- * A function to delist an item from the kiosk.
109
- * @param itemType The type `T` of the item
110
- * @param itemId The ID of the item
111
- */
112
- delist({ itemType, itemId }: ItemId): this;
113
- /**
114
- * A function to take an item from the kiosk. The transaction won't succeed if the item is listed or locked.
115
-
116
- * @param itemType The type `T` of the item
117
- * @param itemId The ID of the item
118
- */
119
- take({ itemType, itemId }: ItemId): TransactionObjectArgument;
120
- /**
121
- * Transfer a non-locked/non-listed item to an address.
122
- *
123
- * @param itemType The type `T` of the item
124
- * @param itemId The ID of the item
125
- * @param address The destination address
126
- */
127
- transfer({ itemType, itemId, address }: ItemId & {
128
- address: string;
129
- }): this;
130
- /**
131
- * A function to take lock an item in the kiosk.
132
-
133
- * @param itemType The type `T` of the item
134
- * @param item The ID or Transaction Argument of the item
135
- * @param itemId The ID of the item - Deprecated: Use `item` instead.
136
- * @param policy The Policy ID or Transaction Argument for item T
137
- */
138
- lock({ itemType, item, itemId, policy, }: ItemReference & {
139
- policy: ObjectArgument;
140
- itemId?: string;
141
- }): this;
142
- /**
143
- * Purchase an item from a seller's kiosk.
144
- * Returns [item, transferRequest]
145
- * Can be called like: `const [item, transferRequest] = kioskTx.purchase({...})`
146
- * @param itemType The type `T` of the item
147
- * @param itemId The ID of the item
148
- * @param price The price in MIST
149
- * @param sellerKiosk The kiosk which is selling the item. Can be an id or an object argument.
150
- */
151
- purchase({ itemType, itemId, price, sellerKiosk, }: ItemId & Price & {
152
- sellerKiosk: ObjectArgument;
153
- }): [
154
- TransactionObjectArgument,
155
- TransactionObjectArgument
156
- ];
157
- /**
158
- * A function to purchase and resolve a transfer policy.
159
- * If the transfer policy has the `lock` rule, the item is locked in the kiosk.
160
- * Otherwise, the item is placed in the kiosk.
161
- * @param itemType The type of the item
162
- * @param itemId The id of the item
163
- * @param price The price of the specified item
164
- * @param sellerKiosk The kiosk which is selling the item. Can be an id or an object argument.
165
- * @param extraArgs Used to pass arguments for custom rule resolvers.
166
- */
167
- purchaseAndResolve({ itemType, itemId, price, sellerKiosk, extraArgs, }: ItemId & Price & {
168
- sellerKiosk: ObjectArgument;
169
- } & PurchaseOptions): Promise<this>;
170
- /**
171
- * A function to setup the client using an existing `ownerCap`,
172
- * as return from the `kioskClient.getOwnedKiosks` function.
173
- * @param cap `KioskOwnerCap` object as returned from `getOwnedKiosks` SDK call.
174
- */
175
- setCap(cap: KioskOwnerCap): this | undefined;
176
- /**
177
- * A function that ends up the kiosk building tx & returns the `kioskOwnerCap` back to the
178
- * `PersonalKioskCap`, in case we are operating on a personal kiosk.
179
- * It will also share the `kiosk` if it's not shared, and finalize the transfer of the personal cap if it's pending.
180
- */
181
- finalize(): void;
182
- setKioskCap(cap: TransactionObjectArgument): this;
183
- setKiosk(kiosk: TransactionObjectArgument): this;
184
- getKiosk(): TransactionObjectArgument;
185
- getKioskCap(): TransactionObjectArgument;
186
- }