@arkade-os/sdk 0.3.13 → 0.4.0-next.1

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 (270) hide show
  1. package/README.md +586 -54
  2. package/dist/cjs/asset/assetGroup.js +141 -0
  3. package/dist/cjs/asset/assetId.js +88 -0
  4. package/dist/cjs/asset/assetInput.js +204 -0
  5. package/dist/cjs/asset/assetOutput.js +159 -0
  6. package/dist/cjs/asset/assetRef.js +82 -0
  7. package/dist/cjs/asset/index.js +24 -0
  8. package/dist/cjs/asset/metadata.js +172 -0
  9. package/dist/cjs/asset/packet.js +164 -0
  10. package/dist/cjs/asset/types.js +25 -0
  11. package/dist/cjs/asset/utils.js +105 -0
  12. package/dist/cjs/bip322/index.js +270 -0
  13. package/dist/cjs/contracts/arkcontract.js +148 -0
  14. package/dist/cjs/contracts/contractManager.js +436 -0
  15. package/dist/cjs/contracts/contractWatcher.js +567 -0
  16. package/dist/cjs/contracts/handlers/default.js +85 -0
  17. package/dist/cjs/contracts/handlers/delegate.js +89 -0
  18. package/dist/cjs/contracts/handlers/helpers.js +105 -0
  19. package/dist/cjs/contracts/handlers/index.js +19 -0
  20. package/dist/cjs/contracts/handlers/registry.js +89 -0
  21. package/dist/cjs/contracts/handlers/vhtlc.js +193 -0
  22. package/dist/cjs/contracts/index.js +41 -0
  23. package/dist/cjs/contracts/types.js +2 -0
  24. package/dist/cjs/forfeit.js +12 -8
  25. package/dist/cjs/identity/index.js +1 -0
  26. package/dist/cjs/identity/seedIdentity.js +255 -0
  27. package/dist/cjs/index.js +72 -14
  28. package/dist/cjs/intent/index.js +47 -11
  29. package/dist/cjs/providers/ark.js +7 -0
  30. package/dist/cjs/providers/delegator.js +66 -0
  31. package/dist/cjs/providers/expoIndexer.js +5 -0
  32. package/dist/cjs/providers/indexer.js +68 -1
  33. package/dist/cjs/providers/utils.js +1 -0
  34. package/dist/cjs/repositories/contractRepository.js +0 -103
  35. package/dist/cjs/repositories/inMemory/contractRepository.js +55 -0
  36. package/dist/cjs/repositories/inMemory/walletRepository.js +80 -0
  37. package/dist/cjs/repositories/index.js +16 -0
  38. package/dist/cjs/repositories/indexedDB/contractRepository.js +187 -0
  39. package/dist/cjs/repositories/indexedDB/db.js +19 -0
  40. package/dist/cjs/repositories/indexedDB/manager.js +97 -0
  41. package/dist/cjs/repositories/indexedDB/schema.js +159 -0
  42. package/dist/cjs/repositories/indexedDB/walletRepository.js +338 -0
  43. package/dist/cjs/repositories/indexedDB/websqlAdapter.js +144 -0
  44. package/dist/cjs/repositories/migrations/contractRepositoryImpl.js +127 -0
  45. package/dist/cjs/repositories/migrations/fromStorageAdapter.js +66 -0
  46. package/dist/cjs/repositories/migrations/walletRepositoryImpl.js +180 -0
  47. package/dist/cjs/repositories/realm/contractRepository.js +120 -0
  48. package/dist/cjs/repositories/realm/index.js +9 -0
  49. package/dist/cjs/repositories/realm/schemas.js +108 -0
  50. package/dist/cjs/repositories/realm/types.js +7 -0
  51. package/dist/cjs/repositories/realm/walletRepository.js +273 -0
  52. package/dist/cjs/repositories/serialization.js +49 -0
  53. package/dist/cjs/repositories/sqlite/contractRepository.js +139 -0
  54. package/dist/cjs/repositories/sqlite/index.js +7 -0
  55. package/dist/cjs/repositories/sqlite/types.js +2 -0
  56. package/dist/cjs/repositories/sqlite/walletRepository.js +328 -0
  57. package/dist/cjs/repositories/walletRepository.js +0 -169
  58. package/dist/cjs/script/base.js +54 -0
  59. package/dist/cjs/script/delegate.js +49 -0
  60. package/dist/cjs/storage/asyncStorage.js +4 -1
  61. package/dist/cjs/storage/fileSystem.js +3 -0
  62. package/dist/cjs/storage/inMemory.js +3 -0
  63. package/dist/cjs/storage/indexedDB.js +5 -1
  64. package/dist/cjs/storage/localStorage.js +3 -0
  65. package/dist/cjs/utils/arkTransaction.js +16 -0
  66. package/dist/cjs/utils/transactionHistory.js +50 -0
  67. package/dist/cjs/wallet/asset-manager.js +338 -0
  68. package/dist/cjs/wallet/asset.js +117 -0
  69. package/dist/cjs/wallet/batch.js +1 -1
  70. package/dist/cjs/wallet/delegator.js +235 -0
  71. package/dist/cjs/wallet/expo/background.js +133 -0
  72. package/dist/cjs/wallet/expo/index.js +9 -0
  73. package/dist/cjs/wallet/expo/wallet.js +231 -0
  74. package/dist/cjs/wallet/serviceWorker/wallet-message-handler.js +568 -0
  75. package/dist/cjs/wallet/serviceWorker/wallet.js +383 -102
  76. package/dist/cjs/wallet/utils.js +58 -0
  77. package/dist/cjs/wallet/validation.js +151 -0
  78. package/dist/cjs/wallet/vtxo-manager.js +8 -1
  79. package/dist/cjs/wallet/wallet.js +702 -260
  80. package/dist/cjs/worker/browser/service-worker-manager.js +82 -0
  81. package/dist/cjs/{wallet/serviceWorker → worker/browser}/utils.js +2 -1
  82. package/dist/cjs/worker/expo/asyncStorageTaskQueue.js +78 -0
  83. package/dist/cjs/worker/expo/index.js +12 -0
  84. package/dist/cjs/worker/expo/processors/contractPollProcessor.js +61 -0
  85. package/dist/cjs/worker/expo/processors/index.js +6 -0
  86. package/dist/cjs/worker/expo/taskQueue.js +41 -0
  87. package/dist/cjs/worker/expo/taskRunner.js +57 -0
  88. package/dist/cjs/worker/messageBus.js +252 -0
  89. package/dist/esm/asset/assetGroup.js +137 -0
  90. package/dist/esm/asset/assetId.js +84 -0
  91. package/dist/esm/asset/assetInput.js +199 -0
  92. package/dist/esm/asset/assetOutput.js +154 -0
  93. package/dist/esm/asset/assetRef.js +78 -0
  94. package/dist/esm/asset/index.js +8 -0
  95. package/dist/esm/asset/metadata.js +167 -0
  96. package/dist/esm/asset/packet.js +159 -0
  97. package/dist/esm/asset/types.js +22 -0
  98. package/dist/esm/asset/utils.js +99 -0
  99. package/dist/esm/bip322/index.js +267 -0
  100. package/dist/esm/contracts/arkcontract.js +141 -0
  101. package/dist/esm/contracts/contractManager.js +432 -0
  102. package/dist/esm/contracts/contractWatcher.js +563 -0
  103. package/dist/esm/contracts/handlers/default.js +82 -0
  104. package/dist/esm/contracts/handlers/delegate.js +86 -0
  105. package/dist/esm/contracts/handlers/helpers.js +66 -0
  106. package/dist/esm/contracts/handlers/index.js +12 -0
  107. package/dist/esm/contracts/handlers/registry.js +86 -0
  108. package/dist/esm/contracts/handlers/vhtlc.js +190 -0
  109. package/dist/esm/contracts/index.js +13 -0
  110. package/dist/esm/contracts/types.js +1 -0
  111. package/dist/esm/forfeit.js +11 -8
  112. package/dist/esm/identity/index.js +1 -0
  113. package/dist/esm/identity/seedIdentity.js +249 -0
  114. package/dist/esm/index.js +28 -15
  115. package/dist/esm/intent/index.js +44 -9
  116. package/dist/esm/providers/ark.js +7 -0
  117. package/dist/esm/providers/delegator.js +62 -0
  118. package/dist/esm/providers/expoIndexer.js +5 -0
  119. package/dist/esm/providers/indexer.js +68 -1
  120. package/dist/esm/providers/utils.js +1 -0
  121. package/dist/esm/repositories/contractRepository.js +1 -101
  122. package/dist/esm/repositories/inMemory/contractRepository.js +51 -0
  123. package/dist/esm/repositories/inMemory/walletRepository.js +76 -0
  124. package/dist/esm/repositories/index.js +8 -0
  125. package/dist/esm/repositories/indexedDB/contractRepository.js +183 -0
  126. package/dist/esm/repositories/indexedDB/db.js +4 -0
  127. package/dist/esm/repositories/indexedDB/manager.js +92 -0
  128. package/dist/esm/repositories/indexedDB/schema.js +155 -0
  129. package/dist/esm/repositories/indexedDB/walletRepository.js +334 -0
  130. package/dist/esm/repositories/indexedDB/websqlAdapter.js +138 -0
  131. package/dist/esm/repositories/migrations/contractRepositoryImpl.js +121 -0
  132. package/dist/esm/repositories/migrations/fromStorageAdapter.js +58 -0
  133. package/dist/esm/repositories/migrations/walletRepositoryImpl.js +176 -0
  134. package/dist/esm/repositories/realm/contractRepository.js +116 -0
  135. package/dist/esm/repositories/realm/index.js +3 -0
  136. package/dist/esm/repositories/realm/schemas.js +105 -0
  137. package/dist/esm/repositories/realm/types.js +6 -0
  138. package/dist/esm/repositories/realm/walletRepository.js +269 -0
  139. package/dist/esm/repositories/serialization.js +40 -0
  140. package/dist/esm/repositories/sqlite/contractRepository.js +135 -0
  141. package/dist/esm/repositories/sqlite/index.js +2 -0
  142. package/dist/esm/repositories/sqlite/types.js +1 -0
  143. package/dist/esm/repositories/sqlite/walletRepository.js +324 -0
  144. package/dist/esm/repositories/walletRepository.js +1 -167
  145. package/dist/esm/script/base.js +21 -1
  146. package/dist/esm/script/delegate.js +46 -0
  147. package/dist/esm/storage/asyncStorage.js +4 -1
  148. package/dist/esm/storage/fileSystem.js +3 -0
  149. package/dist/esm/storage/inMemory.js +3 -0
  150. package/dist/esm/storage/indexedDB.js +5 -1
  151. package/dist/esm/storage/localStorage.js +3 -0
  152. package/dist/esm/utils/arkTransaction.js +15 -0
  153. package/dist/esm/utils/transactionHistory.js +50 -0
  154. package/dist/esm/wallet/asset-manager.js +333 -0
  155. package/dist/esm/wallet/asset.js +111 -0
  156. package/dist/esm/wallet/batch.js +1 -1
  157. package/dist/esm/wallet/delegator.js +231 -0
  158. package/dist/esm/wallet/expo/background.js +128 -0
  159. package/dist/esm/wallet/expo/index.js +2 -0
  160. package/dist/esm/wallet/expo/wallet.js +194 -0
  161. package/dist/esm/wallet/serviceWorker/wallet-message-handler.js +564 -0
  162. package/dist/esm/wallet/serviceWorker/wallet.js +382 -101
  163. package/dist/esm/wallet/utils.js +54 -0
  164. package/dist/esm/wallet/validation.js +139 -0
  165. package/dist/esm/wallet/vtxo-manager.js +8 -1
  166. package/dist/esm/wallet/wallet.js +704 -229
  167. package/dist/esm/worker/browser/service-worker-manager.js +76 -0
  168. package/dist/esm/{wallet/serviceWorker → worker/browser}/utils.js +2 -1
  169. package/dist/esm/worker/expo/asyncStorageTaskQueue.js +74 -0
  170. package/dist/esm/worker/expo/index.js +4 -0
  171. package/dist/esm/worker/expo/processors/contractPollProcessor.js +58 -0
  172. package/dist/esm/worker/expo/processors/index.js +1 -0
  173. package/dist/esm/worker/expo/taskQueue.js +37 -0
  174. package/dist/esm/worker/expo/taskRunner.js +54 -0
  175. package/dist/esm/worker/messageBus.js +248 -0
  176. package/dist/types/asset/assetGroup.d.ts +28 -0
  177. package/dist/types/asset/assetId.d.ts +19 -0
  178. package/dist/types/asset/assetInput.d.ts +46 -0
  179. package/dist/types/asset/assetOutput.d.ts +39 -0
  180. package/dist/types/asset/assetRef.d.ts +25 -0
  181. package/dist/types/asset/index.d.ts +8 -0
  182. package/dist/types/asset/metadata.d.ts +37 -0
  183. package/dist/types/asset/packet.d.ts +27 -0
  184. package/dist/types/asset/types.d.ts +18 -0
  185. package/dist/types/asset/utils.d.ts +21 -0
  186. package/dist/types/bip322/index.d.ts +55 -0
  187. package/dist/types/contracts/arkcontract.d.ts +101 -0
  188. package/dist/types/contracts/contractManager.d.ts +331 -0
  189. package/dist/types/contracts/contractWatcher.d.ts +192 -0
  190. package/dist/types/contracts/handlers/default.d.ts +19 -0
  191. package/dist/types/contracts/handlers/delegate.d.ts +21 -0
  192. package/dist/types/contracts/handlers/helpers.d.ts +18 -0
  193. package/dist/types/contracts/handlers/index.d.ts +7 -0
  194. package/dist/types/contracts/handlers/registry.d.ts +65 -0
  195. package/dist/types/contracts/handlers/vhtlc.d.ts +32 -0
  196. package/dist/types/contracts/index.d.ts +14 -0
  197. package/dist/types/contracts/types.d.ts +222 -0
  198. package/dist/types/forfeit.d.ts +2 -1
  199. package/dist/types/identity/index.d.ts +1 -0
  200. package/dist/types/identity/seedIdentity.d.ts +128 -0
  201. package/dist/types/index.d.ts +22 -12
  202. package/dist/types/intent/index.d.ts +15 -1
  203. package/dist/types/providers/ark.d.ts +11 -2
  204. package/dist/types/providers/delegator.d.ts +29 -0
  205. package/dist/types/providers/indexer.d.ts +11 -1
  206. package/dist/types/repositories/contractRepository.d.ts +30 -19
  207. package/dist/types/repositories/inMemory/contractRepository.d.ts +17 -0
  208. package/dist/types/repositories/inMemory/walletRepository.d.ts +26 -0
  209. package/dist/types/repositories/index.d.ts +7 -0
  210. package/dist/types/repositories/indexedDB/contractRepository.d.ts +21 -0
  211. package/dist/types/repositories/indexedDB/db.d.ts +4 -0
  212. package/dist/types/repositories/indexedDB/manager.d.ts +22 -0
  213. package/dist/types/repositories/indexedDB/schema.d.ts +8 -0
  214. package/dist/types/repositories/indexedDB/walletRepository.d.ts +25 -0
  215. package/dist/types/repositories/indexedDB/websqlAdapter.d.ts +49 -0
  216. package/dist/types/repositories/migrations/contractRepositoryImpl.d.ts +24 -0
  217. package/dist/types/repositories/migrations/fromStorageAdapter.d.ts +19 -0
  218. package/dist/types/repositories/migrations/walletRepositoryImpl.d.ts +27 -0
  219. package/dist/types/repositories/realm/contractRepository.d.ts +24 -0
  220. package/dist/types/repositories/realm/index.d.ts +4 -0
  221. package/dist/types/repositories/realm/schemas.d.ts +208 -0
  222. package/dist/types/repositories/realm/types.d.ts +16 -0
  223. package/dist/types/repositories/realm/walletRepository.d.ts +31 -0
  224. package/dist/types/repositories/serialization.d.ts +40 -0
  225. package/dist/types/repositories/sqlite/contractRepository.d.ts +33 -0
  226. package/dist/types/repositories/sqlite/index.d.ts +3 -0
  227. package/dist/types/repositories/sqlite/types.d.ts +18 -0
  228. package/dist/types/repositories/sqlite/walletRepository.d.ts +40 -0
  229. package/dist/types/repositories/walletRepository.d.ts +13 -24
  230. package/dist/types/script/base.d.ts +1 -0
  231. package/dist/types/script/delegate.d.ts +36 -0
  232. package/dist/types/storage/asyncStorage.d.ts +4 -0
  233. package/dist/types/storage/fileSystem.d.ts +3 -0
  234. package/dist/types/storage/inMemory.d.ts +3 -0
  235. package/dist/types/storage/index.d.ts +3 -0
  236. package/dist/types/storage/indexedDB.d.ts +3 -0
  237. package/dist/types/storage/localStorage.d.ts +3 -0
  238. package/dist/types/utils/arkTransaction.d.ts +6 -0
  239. package/dist/types/wallet/asset-manager.d.ts +78 -0
  240. package/dist/types/wallet/asset.d.ts +21 -0
  241. package/dist/types/wallet/batch.d.ts +1 -1
  242. package/dist/types/wallet/delegator.d.ts +24 -0
  243. package/dist/types/wallet/expo/background.d.ts +66 -0
  244. package/dist/types/wallet/expo/index.d.ts +4 -0
  245. package/dist/types/wallet/expo/wallet.d.ts +97 -0
  246. package/dist/types/wallet/index.d.ts +75 -2
  247. package/dist/types/wallet/serviceWorker/wallet-message-handler.d.ts +366 -0
  248. package/dist/types/wallet/serviceWorker/wallet.d.ts +20 -11
  249. package/dist/types/wallet/utils.d.ts +12 -1
  250. package/dist/types/wallet/validation.d.ts +24 -0
  251. package/dist/types/wallet/wallet.d.ts +111 -17
  252. package/dist/types/worker/browser/service-worker-manager.d.ts +21 -0
  253. package/dist/types/{wallet/serviceWorker → worker/browser}/utils.d.ts +2 -1
  254. package/dist/types/worker/expo/asyncStorageTaskQueue.d.ts +46 -0
  255. package/dist/types/worker/expo/index.d.ts +7 -0
  256. package/dist/types/worker/expo/processors/contractPollProcessor.d.ts +14 -0
  257. package/dist/types/worker/expo/processors/index.d.ts +1 -0
  258. package/dist/types/worker/expo/taskQueue.d.ts +50 -0
  259. package/dist/types/worker/expo/taskRunner.d.ts +42 -0
  260. package/dist/types/worker/messageBus.d.ts +109 -0
  261. package/package.json +69 -11
  262. package/dist/cjs/wallet/serviceWorker/request.js +0 -78
  263. package/dist/cjs/wallet/serviceWorker/response.js +0 -222
  264. package/dist/cjs/wallet/serviceWorker/worker.js +0 -655
  265. package/dist/esm/wallet/serviceWorker/request.js +0 -75
  266. package/dist/esm/wallet/serviceWorker/response.js +0 -219
  267. package/dist/esm/wallet/serviceWorker/worker.js +0 -651
  268. package/dist/types/wallet/serviceWorker/request.d.ts +0 -74
  269. package/dist/types/wallet/serviceWorker/response.d.ts +0 -123
  270. package/dist/types/wallet/serviceWorker/worker.d.ts +0 -53
@@ -1,9 +1,10 @@
1
1
  import { Script, Address, p2tr, taprootListToTree, TAPROOT_UNSPENDABLE_KEY, } from "@scure/btc-signer";
2
+ import * as bip68 from "bip68";
2
3
  import { TAP_LEAF_VERSION } from "@scure/btc-signer/payment.js";
3
4
  import { PSBTOutput } from "@scure/btc-signer/psbt.js";
4
5
  import { hex } from "@scure/base";
5
6
  import { ArkAddress } from './address.js';
6
- import { ConditionCSVMultisigTapscript, CSVMultisigTapscript, } from './tapscript.js';
7
+ import { CLTVMultisigTapscript, ConditionCSVMultisigTapscript, CSVMultisigTapscript, } from './tapscript.js';
7
8
  export const TapTreeCoder = PSBTOutput.tapTree[2];
8
9
  export function scriptFromTapLeafScript(leaf) {
9
10
  return leaf[1].subarray(0, leaf[1].length - 1); // remove the version byte
@@ -90,3 +91,22 @@ export class VtxoScript {
90
91
  return paths;
91
92
  }
92
93
  }
94
+ export function getSequence(tapLeafScript) {
95
+ let sequence = undefined;
96
+ try {
97
+ const scriptWithLeafVersion = tapLeafScript[1];
98
+ const script = scriptWithLeafVersion.subarray(0, scriptWithLeafVersion.length - 1);
99
+ try {
100
+ const params = CSVMultisigTapscript.decode(script).params;
101
+ sequence = bip68.encode(params.timelock.type === "blocks"
102
+ ? { blocks: Number(params.timelock.value) }
103
+ : { seconds: Number(params.timelock.value) });
104
+ }
105
+ catch {
106
+ const params = CLTVMultisigTapscript.decode(script).params;
107
+ sequence = Number(params.absoluteTimelock);
108
+ }
109
+ }
110
+ catch { }
111
+ return sequence;
112
+ }
@@ -0,0 +1,46 @@
1
+ import { DefaultVtxo } from './default.js';
2
+ import { MultisigTapscript } from './tapscript.js';
3
+ import { VtxoScript } from './base.js';
4
+ import { hex } from "@scure/base";
5
+ /**
6
+ * DelegateVtxo extends DefaultVtxo with an extra delegator path
7
+ */
8
+ export var DelegateVtxo;
9
+ (function (DelegateVtxo) {
10
+ /**
11
+ * DelegateVtxo.Script extends DefaultVtxo.Script and adds a delegate path.
12
+ * @example
13
+ * ```typescript
14
+ * const vtxoScript = new DelegateVtxo.Script({
15
+ * pubKey: new Uint8Array(32),
16
+ * serverPubKey: new Uint8Array(32),
17
+ * delegatePubKey: new Uint8Array(32),
18
+ * });
19
+ *
20
+ * console.log("script pub key:", vtxoScript.pkScript)
21
+ * ```
22
+ */
23
+ class Script extends VtxoScript {
24
+ constructor(options) {
25
+ const defaultVtxo = new DefaultVtxo.Script(options);
26
+ const { delegatePubKey, pubKey, serverPubKey } = options;
27
+ const delegateScript = MultisigTapscript.encode({
28
+ pubkeys: [pubKey, delegatePubKey, serverPubKey],
29
+ }).script;
30
+ super([...defaultVtxo.scripts, delegateScript]);
31
+ this.options = options;
32
+ this.defaultVtxo = defaultVtxo;
33
+ this.delegateScript = hex.encode(delegateScript);
34
+ }
35
+ forfeit() {
36
+ return this.findLeaf(this.defaultVtxo.forfeitScript);
37
+ }
38
+ exit() {
39
+ return this.findLeaf(this.defaultVtxo.exitScript);
40
+ }
41
+ delegate() {
42
+ return this.findLeaf(this.delegateScript);
43
+ }
44
+ }
45
+ DelegateVtxo.Script = Script;
46
+ })(DelegateVtxo || (DelegateVtxo = {}));
@@ -1,4 +1,7 @@
1
- // Note: This requires @react-native-async-storage/async-storage to be installed
1
+ /**
2
+ * @deprecated Use repositories instead
3
+ * Note: This requires @react-native-async-storage/async-storage to be installed
4
+ */
2
5
  export class AsyncStorageAdapter {
3
6
  constructor() {
4
7
  try {
@@ -1,5 +1,8 @@
1
1
  import * as fs from "fs/promises";
2
2
  import * as path from "path";
3
+ /**
4
+ * @deprecated Use repositories instead
5
+ */
3
6
  export class FileSystemStorageAdapter {
4
7
  constructor(dirPath) {
5
8
  // Normalize and resolve the storage base path once
@@ -1,3 +1,6 @@
1
+ /**
2
+ * @deprecated Use repositories instead
3
+ */
1
4
  export class InMemoryStorageAdapter {
2
5
  constructor() {
3
6
  this.store = new Map();
@@ -1,5 +1,9 @@
1
+ import { DB_VERSION } from '../repositories/indexedDB/db.js';
2
+ /**
3
+ * @deprecated Use repositories instead
4
+ */
1
5
  export class IndexedDBStorageAdapter {
2
- constructor(dbName, version = 1) {
6
+ constructor(dbName, version = DB_VERSION) {
3
7
  this.db = null;
4
8
  this.dbName = dbName;
5
9
  this.version = version;
@@ -1,3 +1,6 @@
1
+ /**
2
+ * @deprecated Use repositories instead
3
+ */
1
4
  export class LocalStorageAdapter {
2
5
  getSafeLocalStorage() {
3
6
  try {
@@ -7,6 +7,7 @@ import { scriptFromTapLeafScript, VtxoScript, } from '../script/base.js';
7
7
  import { P2A } from './anchor.js';
8
8
  import { setArkPsbtField, VtxoTaprootTree } from './unknownFields.js';
9
9
  import { Transaction } from './transaction.js';
10
+ import { ArkAddress } from '../script/address.js';
10
11
  /**
11
12
  * Builds an offchain transaction with checkpoint transactions.
12
13
  *
@@ -232,3 +233,17 @@ export function combineTapscriptSigs(signedTx, originalTx) {
232
233
  }
233
234
  return originalTx;
234
235
  }
236
+ /**
237
+ * Validates if a given string is a valid Ark address by attempting to decode it.
238
+ * @param address The Ark address to validate.
239
+ * @returns True if the address is valid, false otherwise.
240
+ */
241
+ export function isValidArkAddress(address) {
242
+ try {
243
+ ArkAddress.decode(address);
244
+ return true;
245
+ }
246
+ catch (e) {
247
+ return false;
248
+ }
249
+ }
@@ -4,6 +4,46 @@ const txKey = {
4
4
  boardingTxid: "",
5
5
  arkTxid: "",
6
6
  };
7
+ function collectAssets(vtxos) {
8
+ const map = new Map();
9
+ for (const vtxo of vtxos) {
10
+ if (vtxo.assets) {
11
+ for (const a of vtxo.assets) {
12
+ map.set(a.assetId, (map.get(a.assetId) ?? 0) + a.amount);
13
+ }
14
+ }
15
+ }
16
+ if (map.size === 0)
17
+ return undefined;
18
+ return Array.from(map, ([assetId, amount]) => ({ assetId, amount }));
19
+ }
20
+ function subtractAssets(spent, change) {
21
+ const map = new Map();
22
+ for (const vtxo of change) {
23
+ if (vtxo.assets) {
24
+ for (const a of vtxo.assets) {
25
+ map.set(a.assetId, (map.get(a.assetId) ?? 0) + a.amount);
26
+ }
27
+ }
28
+ }
29
+ for (const vtxo of spent) {
30
+ if (vtxo.assets) {
31
+ for (const a of vtxo.assets) {
32
+ const current = map.get(a.assetId) ?? 0;
33
+ const remaining = current - a.amount;
34
+ if (remaining !== 0) {
35
+ map.set(a.assetId, remaining);
36
+ }
37
+ else {
38
+ map.delete(a.assetId);
39
+ }
40
+ }
41
+ }
42
+ }
43
+ if (map.size === 0)
44
+ return undefined;
45
+ return Array.from(map, ([assetId, amount]) => ({ assetId, amount }));
46
+ }
7
47
  /**
8
48
  * Builds the transaction history by analyzing virtual coins (VTXOs), boarding transactions, and ignored commitments.
9
49
  * History is sorted from newest to oldest and is composed only of SENT and RECEIVED transactions.
@@ -23,6 +63,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
23
63
  // it's translated into a received batch transaction
24
64
  if (!commitmentsToIgnore.has(vtxo.virtualStatus.commitmentTxIds[0]) &&
25
65
  fromOldestVtxo.filter((v) => v.settledBy === vtxo.virtualStatus.commitmentTxIds[0]).length === 0) {
66
+ const assets = collectAssets([vtxo]);
26
67
  received.push({
27
68
  key: {
28
69
  ...txKey,
@@ -33,12 +74,14 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
33
74
  amount: vtxo.value,
34
75
  settled: vtxo.status.isLeaf || vtxo.isSpent,
35
76
  createdAt: vtxo.createdAt.getTime(),
77
+ ...(assets && { assets }),
36
78
  });
37
79
  }
38
80
  }
39
81
  else if (fromOldestVtxo.filter((v) => v.arkTxId === vtxo.txid).length === 0) {
40
82
  // If this vtxo is preconfirmed and does not spend any other vtxos,
41
83
  // it's translated into a received offchain transaction
84
+ const assets = collectAssets([vtxo]);
42
85
  received.push({
43
86
  key: { ...txKey, arkTxid: vtxo.txid },
44
87
  tag: "offchain",
@@ -46,6 +89,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
46
89
  amount: vtxo.value,
47
90
  settled: vtxo.status.isLeaf || vtxo.isSpent,
48
91
  createdAt: vtxo.createdAt.getTime(),
92
+ ...(assets && { assets }),
49
93
  });
50
94
  }
51
95
  // If the vtxo is spent, it's translated into a sent transaction unless:
@@ -74,6 +118,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
74
118
  ? await getTxCreatedAt(vtxo.arkTxId)
75
119
  : vtxo.createdAt.getTime() + 1;
76
120
  }
121
+ const assets = subtractAssets(allSpent, changes);
77
122
  sent.push({
78
123
  key: { ...txKey, arkTxid: vtxo.arkTxId },
79
124
  tag: "offchain",
@@ -81,6 +126,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
81
126
  amount: txAmount,
82
127
  settled: true,
83
128
  createdAt: txTime,
129
+ ...(assets && { assets }),
84
130
  });
85
131
  }
86
132
  // If the vtxo is forfeited in a batch and the total sum of forfeited vtxos is bigger than the sum of new vtxos,
@@ -97,6 +143,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
97
143
  // forfeitAmount > settledAmount --> collaborative exit with offchain change
98
144
  // TODO: make this support fees!
99
145
  if (forfeitAmount > settledAmount) {
146
+ const assets = subtractAssets(forfeitVtxos, changes);
100
147
  sent.push({
101
148
  key: { ...txKey, commitmentTxid: vtxo.settledBy },
102
149
  tag: "exit",
@@ -104,11 +151,13 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
104
151
  amount: forfeitAmount - settledAmount,
105
152
  settled: true,
106
153
  createdAt: changes[0].createdAt.getTime(),
154
+ ...(assets && { assets }),
107
155
  });
108
156
  }
109
157
  }
110
158
  else {
111
159
  // forfeitAmount > 0 && settledAmount == 0 --> collaborative exit without any offchain change
160
+ const assets = subtractAssets(forfeitVtxos, []);
112
161
  sent.push({
113
162
  key: { ...txKey, commitmentTxid: vtxo.settledBy },
114
163
  tag: "exit",
@@ -117,6 +166,7 @@ export async function buildTransactionHistory(vtxos, allBoardingTxs, commitments
117
166
  settled: true,
118
167
  // TODO: fetch commitment tx with /v1/indexer/commitmentTx/<commitmentTxid> to know when the tx was made
119
168
  createdAt: vtxo.createdAt.getTime() + 1,
169
+ ...(assets && { assets }),
120
170
  });
121
171
  }
122
172
  }
@@ -0,0 +1,333 @@
1
+ import { AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, Metadata, Packet, } from '../asset/index.js';
2
+ import { ArkAddress } from '../script/address.js';
3
+ import { selectedCoinsToAssetInputs, selectCoinsWithAsset } from './asset.js';
4
+ import { selectVirtualCoins } from './wallet.js';
5
+ export class ReadonlyAssetManager {
6
+ constructor(indexer) {
7
+ this.indexer = indexer;
8
+ }
9
+ async getAssetDetails(assetId) {
10
+ // TODO: rely on db, and fallback to indexer if not found
11
+ return this.indexer.getAssetDetails(assetId);
12
+ }
13
+ }
14
+ export class AssetManager extends ReadonlyAssetManager {
15
+ constructor(wallet) {
16
+ super(wallet.indexerProvider);
17
+ this.wallet = wallet;
18
+ }
19
+ /**
20
+ * Issue a new asset.
21
+ * @param params - Parameters for asset issuance
22
+ * @param params.amount - Amount of asset units to issue
23
+ * @param params.controlAsset - Optional control asset (for reissuable assets)
24
+ * @param params.metadata - Optional metadata to attach to the asset
25
+ * @returns Promise resolving to the ark transaction ID and asset ID
26
+ *
27
+ * @example
28
+ * ```typescript
29
+ * // Issue a simple non-reissuable asset
30
+ * const result = await wallet.issueAsset({ amount: 1000 });
31
+ * console.log('Asset ID:', result.assetId);
32
+ *
33
+ * // Issue a reissuable asset with a new control asset
34
+ * const result = await wallet.issueAsset({
35
+ * amount: 1000,
36
+ * controlAsset: 1 // creates new control asset with amount 1
37
+ * });
38
+ * console.log('Control Asset ID:', result.controlAssetId);
39
+ * console.log('Asset ID:', result.assetId);
40
+ *
41
+ * // Issue a reissuable asset with an existing control asset
42
+ * const result = await wallet.issueAsset({
43
+ * amount: 1000,
44
+ * controlAsset: 'controlAssetId'
45
+ * });
46
+ * console.log('Control Asset ID:', result.controlAssetId);
47
+ * console.log('Asset ID:', result.assetId);
48
+ * ```
49
+ */
50
+ async issue(params) {
51
+ if (params.amount <= 0) {
52
+ throw new Error(`Issue amount must be greater than 0, got ${params.amount}`);
53
+ }
54
+ const metadata = castMetadata(params.metadata);
55
+ const virtualCoins = await this.wallet.getVtxos({
56
+ withRecoverable: false,
57
+ });
58
+ const controlAssetRef = params.controlAssetId
59
+ ? AssetRef.fromId(AssetId.fromString(params.controlAssetId))
60
+ : null;
61
+ const coinSelection = selectVirtualCoins(virtualCoins, Number(this.wallet.dustAmount));
62
+ let totalBtcSelected = 0n;
63
+ // keep track of asset changes
64
+ const assetChanges = new Map();
65
+ for (const coin of coinSelection.inputs) {
66
+ totalBtcSelected += BigInt(coin.value);
67
+ if (!coin.assets)
68
+ continue;
69
+ for (const { assetId, amount } of coin.assets) {
70
+ const existing = assetChanges.get(assetId) ?? 0n;
71
+ assetChanges.set(assetId, existing + BigInt(amount));
72
+ }
73
+ }
74
+ const groups = [];
75
+ // issued asset group
76
+ const issuedAssetOutput = AssetOutput.create(0, BigInt(params.amount));
77
+ const issuedAssetGroup = AssetGroup.create(null, controlAssetRef, [], [issuedAssetOutput], metadata);
78
+ groups.push(issuedAssetGroup);
79
+ // add asset groups for each asset change
80
+ if (assetChanges.size > 0) {
81
+ const assetInputs = selectedCoinsToAssetInputs(coinSelection.inputs);
82
+ for (const [assetId, amount] of assetChanges) {
83
+ const changeInputs = [];
84
+ // collect all inputs for the asset change
85
+ for (const [inputIndex, assets] of assetInputs) {
86
+ for (const asset of assets) {
87
+ if (asset.assetId !== assetId)
88
+ continue;
89
+ changeInputs.push(AssetInput.create(inputIndex, BigInt(asset.amount)));
90
+ }
91
+ }
92
+ // add the change asset group
93
+ groups.push(AssetGroup.create(AssetId.fromString(assetId), null, changeInputs, [AssetOutput.create(0, amount)], []));
94
+ }
95
+ }
96
+ // build transaction outputs
97
+ const address = await this.wallet.getAddress();
98
+ const outputAddress = ArkAddress.decode(address);
99
+ const outputs = [
100
+ {
101
+ script: outputAddress.pkScript,
102
+ amount: BigInt(totalBtcSelected),
103
+ },
104
+ Packet.create(groups).txOut(),
105
+ ];
106
+ const { arkTxid } = await this.wallet.buildAndSubmitOffchainTx(coinSelection.inputs, outputs);
107
+ return {
108
+ arkTxId: arkTxid,
109
+ assetId: AssetId.create(arkTxid, 0).toString(),
110
+ };
111
+ }
112
+ /**
113
+ * Reissue more units of an existing asset.
114
+ * Requires ownership of the control asset.
115
+ *
116
+ * @param params - Parameters for asset reissuance
117
+ * @param params.assetId - The asset ID to reissue (control asset ID is resolved via getAssetDetails)
118
+ * @param params.amount - Amount of additional units to issue
119
+ * @returns Promise resolving to the ark transaction ID
120
+ *
121
+ * @example
122
+ * ```typescript
123
+ * const txid = await wallet.assetManager.reissue({
124
+ * assetId: 'def456...',
125
+ * amount: 500
126
+ * });
127
+ * ```
128
+ */
129
+ async reissue(params) {
130
+ if (params.amount <= 0) {
131
+ throw new Error(`Reissuance amount must be greater than 0, got ${params.amount}`);
132
+ }
133
+ const { controlAssetId } = await this.getAssetDetails(params.assetId);
134
+ if (!controlAssetId) {
135
+ throw new Error(`Asset ${params.assetId} is not reissuable`);
136
+ }
137
+ const virtualCoins = await this.wallet.getVtxos({
138
+ withRecoverable: false,
139
+ });
140
+ const assetChanges = new Map();
141
+ // select control asset inputs
142
+ const { selected: controlCoins } = selectCoinsWithAsset(virtualCoins, controlAssetId, 1n);
143
+ let selectedCoins = [...controlCoins];
144
+ let assetToReissueAmount = 0n;
145
+ // all control inputs assets go to asset changes, including the control asset itself
146
+ for (const coin of controlCoins) {
147
+ if (!coin.assets)
148
+ continue;
149
+ for (const { assetId, amount } of coin.assets) {
150
+ if (assetId === params.assetId) {
151
+ assetToReissueAmount += BigInt(amount);
152
+ continue;
153
+ }
154
+ const existing = assetChanges.get(assetId) ?? 0n;
155
+ assetChanges.set(assetId, existing + BigInt(amount));
156
+ }
157
+ }
158
+ // select at least dust amount
159
+ const minBtcNeeded = Number(this.wallet.dustAmount);
160
+ let totalBtcSelected = selectedCoins.reduce((sum, c) => sum + c.value, 0);
161
+ if (totalBtcSelected < minBtcNeeded) {
162
+ const remainingCoins = virtualCoins.filter((c) => !selectedCoins.find((sc) => sc.txid === c.txid && sc.vout === c.vout));
163
+ const additional = selectVirtualCoins(remainingCoins, minBtcNeeded - totalBtcSelected);
164
+ for (const coin of additional.inputs) {
165
+ // additional inputs assets go to asset changes
166
+ if (!coin.assets)
167
+ continue;
168
+ for (const { assetId, amount } of coin.assets) {
169
+ if (assetId === params.assetId) {
170
+ assetToReissueAmount += BigInt(amount);
171
+ continue;
172
+ }
173
+ const existing = assetChanges.get(assetId) ?? 0n;
174
+ assetChanges.set(assetId, existing + BigInt(amount));
175
+ }
176
+ }
177
+ selectedCoins = [...selectedCoins, ...additional.inputs];
178
+ totalBtcSelected += additional.inputs.reduce((sum, c) => sum + c.value, 0);
179
+ }
180
+ const assetInputs = selectedCoinsToAssetInputs(selectedCoins);
181
+ // collect all inputs for the asset to reissue
182
+ const reissueInputs = [];
183
+ for (const [inputIndex, assets] of assetInputs) {
184
+ for (const asset of assets) {
185
+ if (asset.assetId !== params.assetId)
186
+ continue;
187
+ reissueInputs.push(AssetInput.create(inputIndex, BigInt(asset.amount)));
188
+ }
189
+ }
190
+ // the total output amount of the asset to reissue = new + (optional) selected amount
191
+ const totalAssetAmount = assetToReissueAmount + BigInt(params.amount);
192
+ const reissueAssetIdObj = AssetId.fromString(params.assetId);
193
+ // create the reissuance asset group
194
+ const reissueAssetGroup = AssetGroup.create(reissueAssetIdObj, null, reissueInputs, [AssetOutput.create(0, totalAssetAmount)], []);
195
+ const groups = [reissueAssetGroup];
196
+ // for each asset change, create a new asset group
197
+ for (const [assetId, amount] of assetChanges) {
198
+ const changeInputs = [];
199
+ for (const [inputIndex, assets] of assetInputs) {
200
+ for (const asset of assets) {
201
+ if (asset.assetId !== assetId)
202
+ continue;
203
+ changeInputs.push(AssetInput.create(inputIndex, BigInt(asset.amount)));
204
+ }
205
+ }
206
+ groups.push(AssetGroup.create(AssetId.fromString(assetId), null, changeInputs, [AssetOutput.create(0, amount)], []));
207
+ }
208
+ // build transaction outputs
209
+ const address = await this.wallet.getAddress();
210
+ const outputAddress = ArkAddress.decode(address);
211
+ const outputs = [
212
+ {
213
+ script: outputAddress.pkScript,
214
+ amount: BigInt(totalBtcSelected),
215
+ },
216
+ Packet.create(groups).txOut(),
217
+ ];
218
+ const { arkTxid } = await this.wallet.buildAndSubmitOffchainTx(selectedCoins, outputs);
219
+ return arkTxid;
220
+ }
221
+ /**
222
+ * Burn assets.
223
+ * @param params - Parameters for burning
224
+ * @param params.assetId - The asset ID to burn
225
+ * @param params.amount - Amount of units to burn
226
+ * @returns Promise resolving to the ark transaction ID
227
+ *
228
+ * @example
229
+ * ```typescript
230
+ * const txid = await wallet.assetManager.burn({
231
+ * assetId: 'abc123...',
232
+ * amount: 100
233
+ * });
234
+ * ```
235
+ */
236
+ async burn(params) {
237
+ if (params.amount <= 0) {
238
+ throw new Error(`Burn amount must be greater than 0, got ${params.amount}`);
239
+ }
240
+ const virtualCoins = await this.wallet.getVtxos({
241
+ withRecoverable: false,
242
+ });
243
+ const assetChanges = new Map();
244
+ // select vtxos with the asset to burn
245
+ const { selected: assetCoins } = selectCoinsWithAsset(virtualCoins, params.assetId, BigInt(params.amount));
246
+ const selectedCoins = [...assetCoins];
247
+ let totalBtcSelected = 0;
248
+ // add the selected coins to asset changes, including the asset to burn
249
+ for (const coin of assetCoins) {
250
+ totalBtcSelected += coin.value;
251
+ if (!coin.assets)
252
+ continue;
253
+ for (const { assetId, amount } of coin.assets) {
254
+ const existing = assetChanges.get(assetId) ?? 0n;
255
+ assetChanges.set(assetId, existing + BigInt(amount));
256
+ }
257
+ }
258
+ // subtract the amount to burn from the asset change
259
+ assetChanges.set(params.assetId, (assetChanges.get(params.assetId) ?? 0n) - BigInt(params.amount));
260
+ const minBtcNeeded = Number(this.wallet.dustAmount);
261
+ // we need to ensure at least dust amount is selected
262
+ // if not, select additional coins
263
+ if (totalBtcSelected < minBtcNeeded) {
264
+ const remainingCoins = virtualCoins.filter((c) => !selectedCoins.find((sc) => sc.txid === c.txid && sc.vout === c.vout));
265
+ const additional = selectVirtualCoins(remainingCoins, minBtcNeeded - totalBtcSelected);
266
+ // additional inputs assets go to asset changes
267
+ for (const coin of additional.inputs) {
268
+ totalBtcSelected += coin.value;
269
+ if (!coin.assets)
270
+ continue;
271
+ for (const { assetId, amount } of coin.assets) {
272
+ const existing = assetChanges.get(assetId) ?? 0n;
273
+ assetChanges.set(assetId, existing + BigInt(amount));
274
+ }
275
+ }
276
+ selectedCoins.push(...additional.inputs);
277
+ }
278
+ const groups = [];
279
+ const assetInputs = selectedCoinsToAssetInputs(selectedCoins);
280
+ // for each asset, create a new asset group
281
+ for (const [assetId, amount] of assetChanges) {
282
+ const changeInputs = [];
283
+ for (const [inputIndex, assets] of assetInputs) {
284
+ for (const asset of assets) {
285
+ if (asset.assetId !== assetId)
286
+ continue;
287
+ changeInputs.push(AssetInput.create(inputIndex, BigInt(asset.amount)));
288
+ }
289
+ }
290
+ groups.push(AssetGroup.create(AssetId.fromString(assetId), null, changeInputs, amount > 0n ? [AssetOutput.create(0, amount)] : [], []));
291
+ }
292
+ // build transaction outputs
293
+ const address = await this.wallet.getAddress();
294
+ const outputAddress = ArkAddress.decode(address);
295
+ const outputs = [
296
+ {
297
+ script: outputAddress.pkScript,
298
+ amount: BigInt(totalBtcSelected),
299
+ },
300
+ Packet.create(groups).txOut(),
301
+ ];
302
+ const { arkTxid } = await this.wallet.buildAndSubmitOffchainTx(selectedCoins, outputs);
303
+ return arkTxid;
304
+ }
305
+ }
306
+ function castMetadata(metadata) {
307
+ if (!metadata) {
308
+ return [];
309
+ }
310
+ const md = [];
311
+ const textEncoder = new TextEncoder();
312
+ for (const [key, value] of Object.entries(metadata)) {
313
+ // convert value to bytes
314
+ let valueBytes;
315
+ if (typeof value === "string") {
316
+ valueBytes = textEncoder.encode(value);
317
+ }
318
+ else if (typeof value === "number") {
319
+ valueBytes = textEncoder.encode(String(value));
320
+ }
321
+ else if (value instanceof Uint8Array) {
322
+ valueBytes = value;
323
+ }
324
+ else if (value instanceof ArrayBuffer) {
325
+ valueBytes = new Uint8Array(value);
326
+ }
327
+ else {
328
+ throw new Error("Invalid metadata value type");
329
+ }
330
+ md.push(Metadata.create(textEncoder.encode(key), valueBytes));
331
+ }
332
+ return md;
333
+ }