@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
@@ -0,0 +1,235 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DelegatorManagerImpl = void 0;
4
+ const __1 = require("..");
5
+ const base_1 = require("@scure/base");
6
+ const base_2 = require("../script/base");
7
+ const forfeit_1 = require("../forfeit");
8
+ const btc_signer_1 = require("@scure/btc-signer");
9
+ const networks_1 = require("../networks");
10
+ class DelegatorManagerImpl {
11
+ constructor(delegatorProvider, arkInfoProvider, identity) {
12
+ this.delegatorProvider = delegatorProvider;
13
+ this.arkInfoProvider = arkInfoProvider;
14
+ this.identity = identity;
15
+ }
16
+ async delegate(vtxos, destination, delegateAt) {
17
+ if (vtxos.length === 0) {
18
+ return { delegated: [], failed: [] };
19
+ }
20
+ const destinationScript = __1.ArkAddress.decode(destination).pkScript;
21
+ // if explicit delegateAt is provided, delegate all vtxos at once without sorting
22
+ if (delegateAt) {
23
+ try {
24
+ await delegate(this.identity, this.delegatorProvider, this.arkInfoProvider, vtxos, destinationScript, delegateAt);
25
+ }
26
+ catch (error) {
27
+ return { delegated: [], failed: [{ outpoints: vtxos, error }] };
28
+ }
29
+ return { delegated: vtxos, failed: [] };
30
+ }
31
+ // if no explicit delegateAt is provided, sort vtxos by expiry and delegate in groups of the same expiry day
32
+ const groupByExpiry = new Map();
33
+ let recoverableVtxos = [];
34
+ for (const vtxo of vtxos) {
35
+ if ((0, __1.isRecoverable)(vtxo)) {
36
+ recoverableVtxos.push(vtxo);
37
+ continue;
38
+ }
39
+ const expiry = vtxo.virtualStatus.batchExpiry;
40
+ if (!expiry)
41
+ continue;
42
+ const dayKey = getDayTimestamp(expiry);
43
+ groupByExpiry.set(dayKey, [
44
+ ...(groupByExpiry.get(dayKey) ?? []),
45
+ vtxo,
46
+ ]);
47
+ }
48
+ // if no groups, it means we only need to delegate the recoverable vtxos
49
+ if (groupByExpiry.size === 0) {
50
+ try {
51
+ await delegate(this.identity, this.delegatorProvider, this.arkInfoProvider, recoverableVtxos, destinationScript, delegateAt);
52
+ }
53
+ catch (error) {
54
+ return {
55
+ delegated: [],
56
+ failed: [{ outpoints: recoverableVtxos, error }],
57
+ };
58
+ }
59
+ return { delegated: recoverableVtxos, failed: [] };
60
+ }
61
+ // search for the earliest group, include recoverable vtxos into it
62
+ const earliestGroup = Math.min(...groupByExpiry.keys());
63
+ groupByExpiry.set(earliestGroup, [
64
+ ...(groupByExpiry.get(earliestGroup) ?? []),
65
+ ...recoverableVtxos,
66
+ ]);
67
+ const groupsList = Array.from(groupByExpiry.entries());
68
+ const result = await Promise.allSettled(groupsList.map(async ([, vtxosGroup]) => delegate(this.identity, this.delegatorProvider, this.arkInfoProvider, vtxosGroup, destinationScript)));
69
+ const delegated = [];
70
+ const failed = [];
71
+ for (const [index, resultItem] of result.entries()) {
72
+ const vtxos = groupsList[index][1];
73
+ if (resultItem.status === "rejected") {
74
+ failed.push({ outpoints: vtxos, error: resultItem.reason });
75
+ continue;
76
+ }
77
+ delegated.push(...vtxos);
78
+ }
79
+ return { delegated, failed };
80
+ }
81
+ }
82
+ exports.DelegatorManagerImpl = DelegatorManagerImpl;
83
+ /**
84
+ * Delegates virtual coins to a delegator provider, allowing them to manage the coins renewal
85
+ * on behalf of the wallet.
86
+ * @param vtxos - Array of extended virtual coins to delegate. Must not be empty.
87
+ * @param delegateAt - Optional Date specifying when the delegation
88
+ * should occur. If not provided, defaults to 12 hours before the earliest
89
+ * expiry time of the provided vtxos.
90
+ */
91
+ async function delegate(identity, delegatorProvider, arkInfoProvider, vtxos, destinationScript, delegateAt) {
92
+ if (vtxos.length === 0) {
93
+ throw new Error("unable to delegate: no vtxos provided");
94
+ }
95
+ if (!delegatorProvider) {
96
+ throw new Error("unable to delegate: delegator provider not configured");
97
+ }
98
+ if (!delegateAt) {
99
+ const expiryTimestamp = vtxos
100
+ .filter((coin) => !(0, __1.isRecoverable)(coin) && coin.virtualStatus.batchExpiry)
101
+ .reduce((min, coin) => Math.min(min, coin.virtualStatus.batchExpiry), Number.MAX_SAFE_INTEGER);
102
+ if (!expiryTimestamp || expiryTimestamp === Number.MAX_SAFE_INTEGER) {
103
+ // if no expiry (recoverable vtxos), delegate 1 minute from now
104
+ delegateAt = new Date(Date.now() + 1 * 60 * 1000);
105
+ }
106
+ else {
107
+ const remainingTimeMs = expiryTimestamp - Date.now();
108
+ if (remainingTimeMs <= 0) {
109
+ delegateAt = new Date(Date.now() + 1 * 60 * 1000);
110
+ }
111
+ else {
112
+ // delegate 10% before the expiry
113
+ delegateAt = new Date(expiryTimestamp - remainingTimeMs * 0.1);
114
+ }
115
+ }
116
+ }
117
+ const { fees, dust, forfeitAddress, network } = await arkInfoProvider.getInfo();
118
+ const delegateAtSeconds = delegateAt.getTime() / 1000;
119
+ const estimator = new __1.Estimator({
120
+ ...fees.intentFee,
121
+ // replace now() function with the delegateAt timestamp
122
+ offchainInput: fees.intentFee.offchainInput?.replace("now()", `double(${delegateAtSeconds})`),
123
+ offchainOutput: fees.intentFee.offchainOutput?.replace("now()", `double(${delegateAtSeconds})`),
124
+ });
125
+ let amount = 0n;
126
+ for (const coin of vtxos) {
127
+ const inputFee = estimator.evalOffchainInput({
128
+ amount: BigInt(coin.value),
129
+ type: "vtxo",
130
+ weight: 0,
131
+ birth: coin.createdAt,
132
+ expiry: coin.virtualStatus.batchExpiry
133
+ ? new Date(coin.virtualStatus.batchExpiry)
134
+ : undefined,
135
+ });
136
+ if (inputFee.value >= coin.value) {
137
+ continue;
138
+ }
139
+ amount += BigInt(coin.value) - BigInt(inputFee.value);
140
+ }
141
+ const { delegatorAddress, pubkey, fee } = await delegatorProvider.getDelegateInfo();
142
+ const outputs = [];
143
+ const delegatorFee = BigInt(Number(fee));
144
+ if (delegatorFee > 0n) {
145
+ outputs.push({
146
+ script: __1.ArkAddress.decode(delegatorAddress).pkScript,
147
+ amount: delegatorFee,
148
+ });
149
+ }
150
+ const outputFee = outputs.reduce((fee, output) => {
151
+ if (!output.amount || !output.script)
152
+ return fee;
153
+ return (fee +
154
+ estimator.evalOffchainOutput({
155
+ amount: output.amount,
156
+ script: base_1.hex.encode(output.script),
157
+ }).satoshis);
158
+ }, 0);
159
+ if (amount - BigInt(outputFee) <= dust) {
160
+ throw new Error("Amount is below dust limit, cannot delegate");
161
+ }
162
+ amount -= BigInt(outputFee);
163
+ amount -= delegatorFee;
164
+ if (amount <= dust) {
165
+ throw new Error("Amount is below dust limit, cannot delegate");
166
+ }
167
+ outputs.push({
168
+ script: destinationScript,
169
+ amount: amount,
170
+ });
171
+ const registerIntent = await makeSignedDelegateIntent(identity, vtxos, outputs, [], [pubkey], delegateAtSeconds);
172
+ const forfeitOutputScript = btc_signer_1.OutScript.encode((0, btc_signer_1.Address)((0, networks_1.getNetwork)(network)).decode(forfeitAddress));
173
+ const forfeits = await Promise.all(vtxos
174
+ .filter((v) => !(0, __1.isRecoverable)(v))
175
+ .map(async (coin) => {
176
+ const forfeit = await makeDelegateForfeitTx(coin, dust, pubkey, forfeitOutputScript, identity);
177
+ return base_1.base64.encode(forfeit.toPSBT());
178
+ }));
179
+ await delegatorProvider.delegate(registerIntent, forfeits);
180
+ }
181
+ async function makeDelegateForfeitTx(input, connectorAmount, delegatePubkey, forfeitOutputScript, identity) {
182
+ if (delegatePubkey.length === 66) {
183
+ delegatePubkey = delegatePubkey.slice(2);
184
+ }
185
+ const vtxoScript = __1.VtxoScript.decode(input.tapTree);
186
+ const delegateTapLeaf = vtxoScript.leaves.find((tapLeaf) => {
187
+ const arkTapscript = (0, __1.decodeTapscript)((0, base_2.scriptFromTapLeafScript)(tapLeaf));
188
+ if (!__1.MultisigTapscript.is(arkTapscript))
189
+ return false;
190
+ if (!arkTapscript.params.pubkeys
191
+ .map(base_1.hex.encode)
192
+ .includes(delegatePubkey))
193
+ return false;
194
+ return true;
195
+ });
196
+ if (!delegateTapLeaf) {
197
+ throw new Error(`delegate tap leaf not found for input: ${input.txid}:${input.vout}`);
198
+ }
199
+ const tx = (0, forfeit_1.buildForfeitTxWithOutput)([
200
+ {
201
+ txid: input.txid,
202
+ index: input.vout,
203
+ witnessUtxo: {
204
+ amount: BigInt(input.value),
205
+ script: __1.VtxoScript.decode(input.tapTree).pkScript,
206
+ },
207
+ sighashType: btc_signer_1.SigHash.ALL_ANYONECANPAY,
208
+ tapLeafScript: [delegateTapLeaf],
209
+ },
210
+ ], {
211
+ script: forfeitOutputScript,
212
+ amount: BigInt(input.value) + connectorAmount,
213
+ });
214
+ return identity.sign(tx);
215
+ }
216
+ async function makeSignedDelegateIntent(identity, coins, outputs, onchainOutputsIndexes, cosignerPubKeys, validAt) {
217
+ const message = {
218
+ type: "register",
219
+ onchain_output_indexes: onchainOutputsIndexes,
220
+ valid_at: Math.floor(validAt),
221
+ expire_at: 0,
222
+ cosigners_public_keys: cosignerPubKeys,
223
+ };
224
+ const proof = __1.Intent.create(message, coins, outputs);
225
+ const signedProof = await identity.sign(proof);
226
+ return {
227
+ proof: base_1.base64.encode(signedProof.toPSBT()),
228
+ message,
229
+ };
230
+ }
231
+ function getDayTimestamp(timestamp) {
232
+ const date = new Date(timestamp);
233
+ date.setUTCHours(0, 0, 0, 0);
234
+ return date.getTime();
235
+ }
@@ -0,0 +1,133 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.defineExpoBackgroundTask = defineExpoBackgroundTask;
4
+ exports.registerExpoBackgroundTask = registerExpoBackgroundTask;
5
+ exports.unregisterExpoBackgroundTask = unregisterExpoBackgroundTask;
6
+ const base_1 = require("@scure/base");
7
+ const taskRunner_1 = require("../../worker/expo/taskRunner");
8
+ const processors_1 = require("../../worker/expo/processors");
9
+ const default_1 = require("../../script/default");
10
+ const expoArk_1 = require("../../providers/expoArk");
11
+ const expoIndexer_1 = require("../../providers/expoIndexer");
12
+ const utils_1 = require("../utils");
13
+ function requireTaskManager() {
14
+ try {
15
+ return require("expo-task-manager");
16
+ }
17
+ catch {
18
+ throw new Error("expo-task-manager is required for background tasks. " +
19
+ "Install it with: npx expo install expo-task-manager");
20
+ }
21
+ }
22
+ function requireBackgroundTask() {
23
+ try {
24
+ return require("expo-background-task");
25
+ }
26
+ catch {
27
+ throw new Error("expo-background-task is required for background tasks. " +
28
+ "Install it with: npx expo install expo-background-task");
29
+ }
30
+ }
31
+ /**
32
+ * Define the Expo background task handler.
33
+ *
34
+ * **Must be called at module/global scope** (before React mounts).
35
+ * Internally calls `TaskManager.defineTask()`.
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * // At the top of your app entry file
40
+ * import { defineExpoBackgroundTask } from "@arkade-os/sdk/wallet/expo";
41
+ * import { AsyncStorageTaskQueue } from "@arkade-os/sdk/worker/expo";
42
+ * import AsyncStorage from "@react-native-async-storage/async-storage";
43
+ *
44
+ * const taskQueue = new AsyncStorageTaskQueue(AsyncStorage);
45
+ * defineExpoBackgroundTask("ark-background-poll", {
46
+ * taskQueue,
47
+ * walletRepository: new IndexedDBWalletRepository(),
48
+ * contractRepository: new IndexedDBContractRepository(),
49
+ * });
50
+ * ```
51
+ */
52
+ function defineExpoBackgroundTask(taskName, options) {
53
+ const TaskManager = requireTaskManager();
54
+ const BackgroundTask = requireBackgroundTask();
55
+ const { taskQueue, walletRepository, contractRepository, processors = [processors_1.contractPollProcessor], } = options;
56
+ TaskManager.defineTask(taskName, async () => {
57
+ try {
58
+ const config = await taskQueue.loadConfig();
59
+ if (!config) {
60
+ // No config persisted yet — ExpoWallet.setup() hasn't run.
61
+ // Nothing to do.
62
+ return BackgroundTask.BackgroundTaskResult.Success;
63
+ }
64
+ // Reconstruct providers
65
+ const indexerProvider = new expoIndexer_1.ExpoIndexerProvider(config.arkServerUrl);
66
+ const arkProvider = new expoArk_1.ExpoArkProvider(config.arkServerUrl);
67
+ // Reconstruct default offchainTapscript as fallback
68
+ // for VTXOs not associated with a contract.
69
+ const defaultTapscript = new default_1.DefaultVtxo.Script({
70
+ pubKey: base_1.hex.decode(config.pubkeyHex),
71
+ serverPubKey: base_1.hex.decode(config.serverPubKeyHex),
72
+ csvTimelock: {
73
+ value: BigInt(config.exitTimelockValue),
74
+ type: config.exitTimelockType,
75
+ },
76
+ });
77
+ await (0, taskRunner_1.runTasks)(taskQueue, processors, {
78
+ walletRepository,
79
+ contractRepository,
80
+ indexerProvider,
81
+ arkProvider,
82
+ extendVtxo: (vtxo, contract) => {
83
+ if (contract) {
84
+ return (0, utils_1.extendVtxoFromContract)(vtxo, contract);
85
+ }
86
+ return (0, utils_1.extendVirtualCoin)({ offchainTapscript: defaultTapscript }, vtxo);
87
+ },
88
+ });
89
+ // Acknowledge outbox results (no foreground to consume them)
90
+ const results = await taskQueue.getResults();
91
+ if (results.length > 0) {
92
+ await taskQueue.acknowledgeResults(results.map((r) => r.id));
93
+ }
94
+ // Re-seed the contract-poll task for the next OS wake
95
+ const existing = await taskQueue.getTasks(processors_1.CONTRACT_POLL_TASK_TYPE);
96
+ if (existing.length === 0) {
97
+ const task = {
98
+ id: (0, utils_1.getRandomId)(),
99
+ type: processors_1.CONTRACT_POLL_TASK_TYPE,
100
+ data: {},
101
+ createdAt: Date.now(),
102
+ };
103
+ await taskQueue.addTask(task);
104
+ }
105
+ return BackgroundTask.BackgroundTaskResult.Success;
106
+ }
107
+ catch (error) {
108
+ console.error("[ark-sdk] Background task failed:", error instanceof Error ? error.message : error);
109
+ return BackgroundTask.BackgroundTaskResult.Failed;
110
+ }
111
+ });
112
+ }
113
+ /**
114
+ * Activate the OS-level background task scheduler.
115
+ *
116
+ * Call this after {@link defineExpoBackgroundTask} (typically inside
117
+ * {@link ExpoWallet.setup} or in a React component after wallet init).
118
+ *
119
+ * @param minimumInterval - Minimum interval in minutes (default 15).
120
+ */
121
+ async function registerExpoBackgroundTask(taskName, options) {
122
+ const BackgroundTask = requireBackgroundTask();
123
+ await BackgroundTask.registerTaskAsync(taskName, {
124
+ minimumInterval: (options?.minimumInterval ?? 15) * 60,
125
+ });
126
+ }
127
+ /**
128
+ * Unregister the background task from the OS scheduler.
129
+ */
130
+ async function unregisterExpoBackgroundTask(taskName) {
131
+ const BackgroundTask = requireBackgroundTask();
132
+ await BackgroundTask.unregisterTaskAsync(taskName);
133
+ }
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.unregisterExpoBackgroundTask = exports.registerExpoBackgroundTask = exports.defineExpoBackgroundTask = exports.ExpoWallet = void 0;
4
+ var wallet_1 = require("./wallet");
5
+ Object.defineProperty(exports, "ExpoWallet", { enumerable: true, get: function () { return wallet_1.ExpoWallet; } });
6
+ var background_1 = require("./background");
7
+ Object.defineProperty(exports, "defineExpoBackgroundTask", { enumerable: true, get: function () { return background_1.defineExpoBackgroundTask; } });
8
+ Object.defineProperty(exports, "registerExpoBackgroundTask", { enumerable: true, get: function () { return background_1.registerExpoBackgroundTask; } });
9
+ Object.defineProperty(exports, "unregisterExpoBackgroundTask", { enumerable: true, get: function () { return background_1.unregisterExpoBackgroundTask; } });
@@ -0,0 +1,231 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.ExpoWallet = void 0;
37
+ const base_1 = require("@scure/base");
38
+ const wallet_1 = require("../wallet");
39
+ const ark_1 = require("../../providers/ark");
40
+ const taskRunner_1 = require("../../worker/expo/taskRunner");
41
+ const processors_1 = require("../../worker/expo/processors");
42
+ const utils_1 = require("../utils");
43
+ const default_1 = require("../../script/default");
44
+ /**
45
+ * Expo/React Native wallet with built-in background task processing.
46
+ *
47
+ * Wraps a standard {@link Wallet} and adds a lightweight task queue
48
+ * for keeping contract/VTXO state fresh while the app is active and
49
+ * across Expo BackgroundTask wakes.
50
+ *
51
+ * @example
52
+ * ```ts
53
+ * import { ExpoWallet } from "@arkade-os/sdk/wallet/expo";
54
+ * import { AsyncStorageTaskQueue } from "@arkade-os/sdk/worker/expo";
55
+ *
56
+ * const wallet = await ExpoWallet.setup({
57
+ * identity: SingleKey.fromHex(privateKey),
58
+ * arkServerUrl,
59
+ * esploraUrl,
60
+ * storage: { walletRepository, contractRepository },
61
+ * background: {
62
+ * taskName: "ark-background-poll",
63
+ * taskQueue: new AsyncStorageTaskQueue(AsyncStorage),
64
+ * foregroundIntervalMs: 20_000,
65
+ * minimumBackgroundInterval: 15,
66
+ * },
67
+ * });
68
+ *
69
+ * const balance = await wallet.getBalance();
70
+ * ```
71
+ */
72
+ class ExpoWallet {
73
+ constructor(wallet, taskQueue, processors, deps, taskName, foregroundIntervalMs) {
74
+ this.wallet = wallet;
75
+ this.taskQueue = taskQueue;
76
+ this.processors = processors;
77
+ this.deps = deps;
78
+ this.identity = wallet.identity;
79
+ this.arkProvider = wallet.arkProvider;
80
+ this.indexerProvider = wallet.indexerProvider;
81
+ this.taskName = taskName;
82
+ if (foregroundIntervalMs && foregroundIntervalMs > 0) {
83
+ this.startForegroundPolling(foregroundIntervalMs);
84
+ }
85
+ }
86
+ /**
87
+ * Create an ExpoWallet with background task support.
88
+ *
89
+ * 1. Creates the inner {@link Wallet} via `Wallet.create()`.
90
+ * 2. Wires up processors (defaults to {@link contractPollProcessor}).
91
+ * 3. Persists background config for the background handler (if the queue supports it).
92
+ * 4. Seeds the task queue with a `contract-poll` task.
93
+ * 5. Registers the background task with the OS scheduler (if `minimumBackgroundInterval` is set).
94
+ * 6. Starts foreground polling if `foregroundIntervalMs` is set.
95
+ */
96
+ static async setup(config) {
97
+ const wallet = await wallet_1.Wallet.create(config);
98
+ const processors = config.background.processors ?? [
99
+ processors_1.contractPollProcessor,
100
+ ];
101
+ const deps = {
102
+ walletRepository: wallet.walletRepository,
103
+ contractRepository: wallet.contractRepository,
104
+ indexerProvider: wallet.indexerProvider,
105
+ arkProvider: wallet.arkProvider,
106
+ extendVtxo: (vtxo, contract) => {
107
+ if (contract) {
108
+ return (0, utils_1.extendVtxoFromContract)(vtxo, contract);
109
+ }
110
+ return (0, utils_1.extendVirtualCoin)(wallet, vtxo);
111
+ },
112
+ };
113
+ const { taskQueue } = config.background;
114
+ // Persist wallet params so the background handler can rehydrate
115
+ // without a network call. Only works with AsyncStorageTaskQueue.
116
+ if ("persistConfig" in taskQueue) {
117
+ const arkServerUrl = config.arkServerUrl ??
118
+ (wallet.arkProvider instanceof ark_1.RestArkProvider
119
+ ? wallet.arkProvider.serverUrl
120
+ : undefined);
121
+ if (arkServerUrl) {
122
+ const timelock = wallet.offchainTapscript.options.csvTimelock ??
123
+ default_1.DefaultVtxo.Script.DEFAULT_TIMELOCK;
124
+ const bgConfig = {
125
+ arkServerUrl,
126
+ pubkeyHex: base_1.hex.encode(wallet.offchainTapscript.options.pubKey),
127
+ serverPubKeyHex: base_1.hex.encode(wallet.offchainTapscript.options.serverPubKey),
128
+ exitTimelockValue: timelock.value.toString(),
129
+ exitTimelockType: timelock.type,
130
+ };
131
+ await taskQueue.persistConfig(bgConfig);
132
+ }
133
+ }
134
+ const expoWallet = new ExpoWallet(wallet, taskQueue, processors, deps, config.background.taskName, config.background.foregroundIntervalMs);
135
+ // Seed the queue so the first tick (or background wake) has work to do
136
+ await expoWallet.seedContractPollTask();
137
+ // Activate OS-level background scheduling
138
+ if (config.background.minimumBackgroundInterval) {
139
+ try {
140
+ const { registerExpoBackgroundTask } = await Promise.resolve().then(() => __importStar(require("./background")));
141
+ await registerExpoBackgroundTask(config.background.taskName, {
142
+ minimumInterval: config.background.minimumBackgroundInterval,
143
+ });
144
+ }
145
+ catch {
146
+ // expo-background-task not installed — foreground-only mode
147
+ }
148
+ }
149
+ return expoWallet;
150
+ }
151
+ // ── Foreground polling ───────────────────────────────────────────
152
+ startForegroundPolling(intervalMs) {
153
+ this.foregroundIntervalId = setInterval(() => {
154
+ this.runForegroundPoll().catch(console.error);
155
+ }, intervalMs);
156
+ }
157
+ async runForegroundPoll() {
158
+ await (0, taskRunner_1.runTasks)(this.taskQueue, this.processors, this.deps);
159
+ // Consume results immediately (no background handoff needed)
160
+ const results = await this.taskQueue.getResults();
161
+ if (results.length > 0) {
162
+ await this.taskQueue.acknowledgeResults(results.map((r) => r.id));
163
+ }
164
+ // Re-seed for the next tick
165
+ await this.seedContractPollTask();
166
+ }
167
+ async seedContractPollTask() {
168
+ const existing = await this.taskQueue.getTasks(processors_1.CONTRACT_POLL_TASK_TYPE);
169
+ if (existing.length > 0)
170
+ return;
171
+ const task = {
172
+ id: (0, utils_1.getRandomId)(),
173
+ type: processors_1.CONTRACT_POLL_TASK_TYPE,
174
+ data: {},
175
+ createdAt: Date.now(),
176
+ };
177
+ await this.taskQueue.addTask(task);
178
+ }
179
+ // ── Lifecycle ────────────────────────────────────────────────────
180
+ /**
181
+ * Stop foreground polling and unregister the background task.
182
+ */
183
+ async dispose() {
184
+ if (this.foregroundIntervalId) {
185
+ clearInterval(this.foregroundIntervalId);
186
+ this.foregroundIntervalId = undefined;
187
+ }
188
+ try {
189
+ const { unregisterExpoBackgroundTask } = await Promise.resolve().then(() => __importStar(require("./background")));
190
+ await unregisterExpoBackgroundTask(this.taskName);
191
+ }
192
+ catch {
193
+ // expo-background-task not installed — nothing to unregister
194
+ }
195
+ }
196
+ // ── IWallet delegation ───────────────────────────────────────────
197
+ getAddress() {
198
+ return this.wallet.getAddress();
199
+ }
200
+ getBoardingAddress() {
201
+ return this.wallet.getBoardingAddress();
202
+ }
203
+ getBalance() {
204
+ return this.wallet.getBalance();
205
+ }
206
+ getVtxos(filter) {
207
+ return this.wallet.getVtxos(filter);
208
+ }
209
+ getBoardingUtxos() {
210
+ return this.wallet.getBoardingUtxos();
211
+ }
212
+ getTransactionHistory() {
213
+ return this.wallet.getTransactionHistory();
214
+ }
215
+ getContractManager() {
216
+ return this.wallet.getContractManager();
217
+ }
218
+ sendBitcoin(params) {
219
+ return this.wallet.sendBitcoin(params);
220
+ }
221
+ settle(params, eventCallback) {
222
+ return this.wallet.settle(params, eventCallback);
223
+ }
224
+ send(...recipients) {
225
+ return this.wallet.send(...recipients);
226
+ }
227
+ get assetManager() {
228
+ return this.wallet.assetManager;
229
+ }
230
+ }
231
+ exports.ExpoWallet = ExpoWallet;