@owney/sdk 0.7.32-beta.8 → 0.7.32-beta.9
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.
- package/dist/index.cjs +249 -53
- package/dist/index.d.cts +62 -26
- package/dist/index.d.ts +62 -26
- package/dist/index.js +249 -53
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -586,13 +586,12 @@ type UserPoolSelection = {
|
|
|
586
586
|
/**
|
|
587
587
|
* The complete saved draft for the asset/chain legs selected in the deposit.
|
|
588
588
|
*
|
|
589
|
-
*
|
|
590
|
-
*
|
|
591
|
-
*
|
|
592
|
-
*
|
|
593
|
-
*
|
|
594
|
-
*
|
|
595
|
-
* (`availablePools` empty) change nothing.
|
|
589
|
+
* Every agent keeps at least one pool (2026-11-11): a request whose every
|
|
590
|
+
* entry for an asset and chain has empty `pools` (with pools shown) is
|
|
591
|
+
* refused with POOL_SELECTION_REQUIRED before anything is written, unless
|
|
592
|
+
* (Zyfai) a protocol the request does not touch keeps a pool there. A "none
|
|
593
|
+
* chosen" saved before that rule is still read back as none. Entries that
|
|
594
|
+
* showed nothing (`availablePools` empty) change nothing.
|
|
596
595
|
*/
|
|
597
596
|
type UserPoolSelectionRequest = {
|
|
598
597
|
strategies: Array<{
|
|
@@ -752,7 +751,11 @@ interface IAgent {
|
|
|
752
751
|
/**
|
|
753
752
|
* Apply a user's own pool selection to their account, driven by the
|
|
754
753
|
* deposit-time Pools step. Optional. A failure throws, and the caller
|
|
755
|
-
* must not start the deposit.
|
|
754
|
+
* must not start the deposit. A save must also reach money already
|
|
755
|
+
* invested: Zyfai rebalances on its own, Yieldseeker is told with
|
|
756
|
+
* `deposit-made`. Every agent keeps at least one pool: a selection that
|
|
757
|
+
* would leave the agent with no pool for an asset on a chain it offers pools
|
|
758
|
+
* for throws POOL_SELECTION_REQUIRED before anything is written.
|
|
756
759
|
* `state` is the client's connection, or undefined when there is none; an
|
|
757
760
|
* agent that signs in per call (Yieldseeker) needs it, and one that is
|
|
758
761
|
* already connected (Zyfai) ignores it. (ROUT-569)
|
|
@@ -829,6 +832,11 @@ interface IAgent {
|
|
|
829
832
|
getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
|
|
830
833
|
/** Funding-ledger read access for earnings holds. Optional; without it an agent behaves as before. */
|
|
831
834
|
setFundingLedgerAccess?(access: AgentFundingLedgerAccess | undefined): void;
|
|
835
|
+
/**
|
|
836
|
+
* Called each time the agent maps a provider refusal for a wallet whose
|
|
837
|
+
* account was not created through Owney (AGENT_ACCOUNT_NOT_OWNEY). Optional.
|
|
838
|
+
*/
|
|
839
|
+
setAccountRefusedListener?(listener: (() => void) | undefined): void;
|
|
832
840
|
/**
|
|
833
841
|
* A small, never-prompting read of the provider's earnings bookkeeping for a
|
|
834
842
|
* `provider.sample` ledger event (Zyfai). Null when unavailable; never throws.
|
|
@@ -1786,7 +1794,7 @@ type WithdrawalPayoutScan = {
|
|
|
1786
1794
|
caughtUp: boolean;
|
|
1787
1795
|
};
|
|
1788
1796
|
|
|
1789
|
-
type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "AGENT_ACTIVATION_BLOCKED" | "YIELDSEEKER_AGENT_MISSING" | "YIELDSEEKER_AGENT_CLOSED" | "YIELDSEEKER_SLOT_UNAVAILABLE" | "YIELDSEEKER_WALLET_UNVERIFIED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_IN_PROGRESS" | "DEPOSIT_CHECKPOINT_FAILED" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "ALL_AGENTS_EXCLUDED" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_NOTHING_TO_WITHDRAW" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_SWAP_INCOMPLETE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "WITHDRAW_RESERVATION_UNAVAILABLE" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "AGENT_APY_PERIOD_UNSUPPORTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "SWAP_DISABLED" | "SWAP_RATE_LIMITED" | "SWAP_REQUEST_FAILED" | "SWAP_QUOTE_FAILED" | "SWAP_UNSUPPORTED_PAIR" | "SWAP_APPROVAL_REQUIRED" | "SWAP_BELOW_DEPOSIT_MINIMUM" | "SWAP_DEPOSIT_PENDING" | "SWAP_WALLET_PROMPT_TIMEOUT" | "SWAP_INSUFFICIENT_GAS" | "SWAP_NATIVE_UNSUPPORTED" | "SWAP_ORDER_EXPIRED" | "SWAP_ORDER_REFUNDED" | "SWAP_ORDER_CANCELLED" | "SWAP_ORDER_NOT_FOUND" | "WITHDRAW_ARRIVAL_TIMEOUT" | "WITHDRAW_SWAP_FAILED" | "BALANCE_ALL_FAILED" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "POOL_CATALOG_UNSUPPORTED" | "POOL_SELECTION_UNSUPPORTED" | "POOL_SELECTION_NOT_APPLIED" | "POOL_SELECTION_RULE_LIMIT" | "VALIDATION_INVALID_DAYS";
|
|
1797
|
+
type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "AGENT_ACTIVATION_BLOCKED" | "AGENT_ACCOUNT_NOT_OWNEY" | "YIELDSEEKER_AGENT_MISSING" | "YIELDSEEKER_AGENT_CLOSED" | "YIELDSEEKER_SLOT_UNAVAILABLE" | "YIELDSEEKER_WALLET_UNVERIFIED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_IN_PROGRESS" | "DEPOSIT_CHECKPOINT_FAILED" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "ALL_AGENTS_EXCLUDED" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_NOTHING_TO_WITHDRAW" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_SWAP_INCOMPLETE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "WITHDRAW_RESERVATION_UNAVAILABLE" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "AGENT_APY_PERIOD_UNSUPPORTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "SWAP_DISABLED" | "SWAP_RATE_LIMITED" | "SWAP_REQUEST_FAILED" | "SWAP_QUOTE_FAILED" | "SWAP_UNSUPPORTED_PAIR" | "SWAP_APPROVAL_REQUIRED" | "SWAP_BELOW_DEPOSIT_MINIMUM" | "SWAP_DEPOSIT_PENDING" | "SWAP_WALLET_PROMPT_TIMEOUT" | "SWAP_INSUFFICIENT_GAS" | "SWAP_NATIVE_UNSUPPORTED" | "SWAP_ORDER_EXPIRED" | "SWAP_ORDER_REFUNDED" | "SWAP_ORDER_CANCELLED" | "SWAP_ORDER_NOT_FOUND" | "WITHDRAW_ARRIVAL_TIMEOUT" | "WITHDRAW_SWAP_FAILED" | "BALANCE_ALL_FAILED" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "POOL_CATALOG_UNSUPPORTED" | "POOL_SELECTION_UNSUPPORTED" | "POOL_SELECTION_NOT_APPLIED" | "POOL_SELECTION_RULE_LIMIT" | "POOL_SELECTION_REQUIRED" | "VALIDATION_INVALID_DAYS";
|
|
1790
1798
|
declare class OwneyError extends Error {
|
|
1791
1799
|
readonly code: OwneyErrorCode;
|
|
1792
1800
|
readonly details?: Record<string, unknown>;
|
|
@@ -1957,6 +1965,7 @@ declare class OwneySDK {
|
|
|
1957
1965
|
* withdraw, but they are excluded from new deposits / activations.
|
|
1958
1966
|
*/
|
|
1959
1967
|
private disabledAgents;
|
|
1968
|
+
private readonly accountRefusedListeners;
|
|
1960
1969
|
/**
|
|
1961
1970
|
* Agents whose sign-in the user cancelled this session (the wallet rejected
|
|
1962
1971
|
* the prompt), keyed by chain. Until the app ends the session they are read
|
|
@@ -2050,6 +2059,14 @@ declare class OwneySDK {
|
|
|
2050
2059
|
* a later sample is skipped once the wallet disconnects or changes.
|
|
2051
2060
|
*/
|
|
2052
2061
|
private ledgerProviderSamples;
|
|
2062
|
+
/**
|
|
2063
|
+
* Listens for an agent refusing the connected wallet because its provider
|
|
2064
|
+
* account was not created through Owney (`AGENT_ACCOUNT_NOT_OWNEY`). Fires
|
|
2065
|
+
* each time an agent maps such a refusal. Returns the unsubscribe function.
|
|
2066
|
+
*/
|
|
2067
|
+
onAccountRefused(listener: (agentId: AgentId) => void): () => void;
|
|
2068
|
+
/** Wires the optional hooks the SDK offers an agent. */
|
|
2069
|
+
private attachAgentHooks;
|
|
2053
2070
|
/**
|
|
2054
2071
|
* Funding-ledger read access handed to agents for earnings holds. Reads only
|
|
2055
2072
|
* for the connected owner; null otherwise and on any failure.
|
|
@@ -3190,6 +3207,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3190
3207
|
private readonly agentContexts;
|
|
3191
3208
|
private readonly walletContexts;
|
|
3192
3209
|
private readonly agentAccountReads;
|
|
3210
|
+
private readonly sessionAgents;
|
|
3193
3211
|
private readonly reportedAccounts;
|
|
3194
3212
|
private readonly missingSlots;
|
|
3195
3213
|
private readonly rethrownSlotFailures;
|
|
@@ -3223,6 +3241,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3223
3241
|
private readonly movementEpochs;
|
|
3224
3242
|
private readonly settlementChecks;
|
|
3225
3243
|
private ledgerAccess?;
|
|
3244
|
+
private accountRefusedListener?;
|
|
3226
3245
|
private readonly ledgerReads;
|
|
3227
3246
|
/** contextKey -> movements this instance started settling (by tx hash) and how they refresh:
|
|
3228
3247
|
* awaiting the ledger, refreshed when ready (ledger), or on the timed backoff (legacy). */
|
|
@@ -3261,8 +3280,9 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3261
3280
|
* - closed (`deactivatedDate` set): reactivates it, re-reads the wallet, and
|
|
3262
3281
|
* continues only when it is now open with the same address. Only the
|
|
3263
3282
|
* verified record's agent is reopened: any other closed agent (a
|
|
3264
|
-
* superseded-wallet match, or
|
|
3265
|
-
* when the accounts could not be read)
|
|
3283
|
+
* superseded-wallet match, or the agent this session created or adopted
|
|
3284
|
+
* before its record exists, also when the accounts could not be read)
|
|
3285
|
+
* refuses without a request;
|
|
3266
3286
|
* - anything else refuses with nothing sent, before any progress event,
|
|
3267
3287
|
* signature or callback. Every refusal carries `notSubmitted` and
|
|
3268
3288
|
* `safeToFallback: false`, so no paid fallback runs.
|
|
@@ -3353,6 +3373,13 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3353
3373
|
}) => void): Promise<DepositNotice>;
|
|
3354
3374
|
/** One `deposit-made` call. A failure that may pass on its own carries the wait before the next try. */
|
|
3355
3375
|
private sendDepositNotice;
|
|
3376
|
+
/**
|
|
3377
|
+
* Tells Yieldseeker (`deposit-made`) after a pool save, so the agent runs
|
|
3378
|
+
* now and rebalances money already in a vault the list no longer allows.
|
|
3379
|
+
* Up to DEPOSIT_NOTICE_ATTEMPTS calls in all, waiting between them only
|
|
3380
|
+
* after a failure that may pass; stops when the session ends. Never throws.
|
|
3381
|
+
*/
|
|
3382
|
+
private rebalanceAfterPoolSave;
|
|
3356
3383
|
/**
|
|
3357
3384
|
* When Yieldseeker may move funds again after this agent wallet's last
|
|
3358
3385
|
* confirmed withdrawal, if that is still ahead; null when there was none in
|
|
@@ -3409,13 +3436,11 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3409
3436
|
*
|
|
3410
3437
|
* - Only Base entries are ours. An asset with no picks whose entries showed
|
|
3411
3438
|
* no vault is skipped and nothing is sent.
|
|
3439
|
+
* - None picked (vaults shown) for any asset: every agent keeps at least one
|
|
3440
|
+
* pool (2026-11-11), so the whole save throws POOL_SELECTION_REQUIRED
|
|
3441
|
+
* before anything is written, for any asset.
|
|
3412
3442
|
* - Some vaults picked: the managed list names them. Saving it again
|
|
3413
3443
|
* replaces it, so there is only ever one.
|
|
3414
|
-
* - None picked (vaults shown): the managed list names no vault, and the
|
|
3415
|
-
* rules must read back as an empty allow-list. Yieldseeker then keeps the
|
|
3416
|
-
* agent's money out of every vault, as Zyfai does with an empty pool list,
|
|
3417
|
-
* and the next Pools step reads "none". Only an agent that already exists
|
|
3418
|
-
* is written: one is never created just to hold "none".
|
|
3419
3444
|
* - Every vault picked: the managed list is deleted, and no allow-list may
|
|
3420
3445
|
* remain, so vaults Yieldseeker adds later are allowed too.
|
|
3421
3446
|
* - A free-text allow-list we saved before the managed list existed is
|
|
@@ -3440,7 +3465,8 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3440
3465
|
private deleteLegacyPoolMemories;
|
|
3441
3466
|
/**
|
|
3442
3467
|
* `<address> (<name>)` for each pick, under the prefix. An unnamed address
|
|
3443
|
-
* has no brackets.
|
|
3468
|
+
* has no brackets. There is always at least one pick (setPoolSelection
|
|
3469
|
+
* refuses a save with none).
|
|
3444
3470
|
*/
|
|
3445
3471
|
private poolMemoryContent;
|
|
3446
3472
|
/** Undo a failed save of the managed list. Never throws: the caller reports the save's own failure. */
|
|
@@ -3507,8 +3533,9 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3507
3533
|
private listAgents;
|
|
3508
3534
|
/**
|
|
3509
3535
|
* The routing API's stored accounts for owner+chain, read once per session.
|
|
3510
|
-
* Resolves null when unavailable
|
|
3511
|
-
*
|
|
3536
|
+
* Resolves null when unavailable and never rejects; callers then refuse
|
|
3537
|
+
* (AGENT_ACCOUNTS_UNAVAILABLE) and create nothing. A failure is not kept:
|
|
3538
|
+
* concurrent callers share the in-flight read, and the next call reads again.
|
|
3512
3539
|
*/
|
|
3513
3540
|
private agentAccounts;
|
|
3514
3541
|
/** Yieldseeker accounts for one slot (returned addresses are compared lowercase). */
|
|
@@ -3591,11 +3618,15 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3591
3618
|
* 1. the listed fitting agent whose wallet is the verified account's wallet,
|
|
3592
3619
|
* whatever its name; the stored agentId is only a hint;
|
|
3593
3620
|
* 2. else a listed fitting agent whose wallet is a superseded account's wallet;
|
|
3594
|
-
* 3. else
|
|
3595
|
-
*
|
|
3596
|
-
*
|
|
3597
|
-
*
|
|
3598
|
-
*
|
|
3621
|
+
* 3. else, with a verified account, throw YIELDSEEKER_AGENT_MISSING (never
|
|
3622
|
+
* create);
|
|
3623
|
+
* 4. else, with no record at all, the listed agent this session created or
|
|
3624
|
+
* adopted for the slot (sessionAgents); without one, undefined (the
|
|
3625
|
+
* caller creates an agent named "owney"). An agent is never picked by
|
|
3626
|
+
* its name: only our records, and this session's own create, say which
|
|
3627
|
+
* agents are Owney's.
|
|
3628
|
+
* Without the account records (`null`: the read failed) nothing can be
|
|
3629
|
+
* known, so the call is refused and nothing is created.
|
|
3599
3630
|
* Steps 1 and 2 share one search of at most YIELDSEEKER_WALLET_MATCH_LIMIT
|
|
3600
3631
|
* wallet reads. The account report then records the selected wallet; the
|
|
3601
3632
|
* server marks it superseded when it differs from the verified wallet.
|
|
@@ -3628,7 +3659,12 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3628
3659
|
private ensureAgent;
|
|
3629
3660
|
private findAgent;
|
|
3630
3661
|
private resolveAgent;
|
|
3631
|
-
/**
|
|
3662
|
+
/**
|
|
3663
|
+
* Create the slot's agent, named "owney". Only reached when the slot has no
|
|
3664
|
+
* account record and no agent this session made; the created agent is
|
|
3665
|
+
* remembered for the session (sessionAgents) so reads select it before its
|
|
3666
|
+
* record exists.
|
|
3667
|
+
*/
|
|
3632
3668
|
private createAgent;
|
|
3633
3669
|
/**
|
|
3634
3670
|
* The routing create lock refused the create: another tab or app owns or is
|
|
@@ -3664,6 +3700,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3664
3700
|
private loadActivityContext;
|
|
3665
3701
|
private loadPortfolioParts;
|
|
3666
3702
|
private deployAgent;
|
|
3703
|
+
setAccountRefusedListener(listener: (() => void) | undefined): void;
|
|
3667
3704
|
setFundingLedgerAccess(access: AgentFundingLedgerAccess | undefined): void;
|
|
3668
3705
|
private historyKey;
|
|
3669
3706
|
/** Funding-ledger rows for this slot, cached 15 s. Never throws: null on any failure. */
|
|
@@ -3733,7 +3770,6 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3733
3770
|
private waitForReceipt;
|
|
3734
3771
|
private assertTransaction;
|
|
3735
3772
|
private assertAgent;
|
|
3736
|
-
private isOwneyAgent;
|
|
3737
3773
|
private assetForAgent;
|
|
3738
3774
|
private isTransactionHash;
|
|
3739
3775
|
private assertChain;
|
package/dist/index.d.ts
CHANGED
|
@@ -586,13 +586,12 @@ type UserPoolSelection = {
|
|
|
586
586
|
/**
|
|
587
587
|
* The complete saved draft for the asset/chain legs selected in the deposit.
|
|
588
588
|
*
|
|
589
|
-
*
|
|
590
|
-
*
|
|
591
|
-
*
|
|
592
|
-
*
|
|
593
|
-
*
|
|
594
|
-
*
|
|
595
|
-
* (`availablePools` empty) change nothing.
|
|
589
|
+
* Every agent keeps at least one pool (2026-11-11): a request whose every
|
|
590
|
+
* entry for an asset and chain has empty `pools` (with pools shown) is
|
|
591
|
+
* refused with POOL_SELECTION_REQUIRED before anything is written, unless
|
|
592
|
+
* (Zyfai) a protocol the request does not touch keeps a pool there. A "none
|
|
593
|
+
* chosen" saved before that rule is still read back as none. Entries that
|
|
594
|
+
* showed nothing (`availablePools` empty) change nothing.
|
|
596
595
|
*/
|
|
597
596
|
type UserPoolSelectionRequest = {
|
|
598
597
|
strategies: Array<{
|
|
@@ -752,7 +751,11 @@ interface IAgent {
|
|
|
752
751
|
/**
|
|
753
752
|
* Apply a user's own pool selection to their account, driven by the
|
|
754
753
|
* deposit-time Pools step. Optional. A failure throws, and the caller
|
|
755
|
-
* must not start the deposit.
|
|
754
|
+
* must not start the deposit. A save must also reach money already
|
|
755
|
+
* invested: Zyfai rebalances on its own, Yieldseeker is told with
|
|
756
|
+
* `deposit-made`. Every agent keeps at least one pool: a selection that
|
|
757
|
+
* would leave the agent with no pool for an asset on a chain it offers pools
|
|
758
|
+
* for throws POOL_SELECTION_REQUIRED before anything is written.
|
|
756
759
|
* `state` is the client's connection, or undefined when there is none; an
|
|
757
760
|
* agent that signs in per call (Yieldseeker) needs it, and one that is
|
|
758
761
|
* already connected (Zyfai) ignores it. (ROUT-569)
|
|
@@ -829,6 +832,11 @@ interface IAgent {
|
|
|
829
832
|
getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
|
|
830
833
|
/** Funding-ledger read access for earnings holds. Optional; without it an agent behaves as before. */
|
|
831
834
|
setFundingLedgerAccess?(access: AgentFundingLedgerAccess | undefined): void;
|
|
835
|
+
/**
|
|
836
|
+
* Called each time the agent maps a provider refusal for a wallet whose
|
|
837
|
+
* account was not created through Owney (AGENT_ACCOUNT_NOT_OWNEY). Optional.
|
|
838
|
+
*/
|
|
839
|
+
setAccountRefusedListener?(listener: (() => void) | undefined): void;
|
|
832
840
|
/**
|
|
833
841
|
* A small, never-prompting read of the provider's earnings bookkeeping for a
|
|
834
842
|
* `provider.sample` ledger event (Zyfai). Null when unavailable; never throws.
|
|
@@ -1786,7 +1794,7 @@ type WithdrawalPayoutScan = {
|
|
|
1786
1794
|
caughtUp: boolean;
|
|
1787
1795
|
};
|
|
1788
1796
|
|
|
1789
|
-
type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "AGENT_ACTIVATION_BLOCKED" | "YIELDSEEKER_AGENT_MISSING" | "YIELDSEEKER_AGENT_CLOSED" | "YIELDSEEKER_SLOT_UNAVAILABLE" | "YIELDSEEKER_WALLET_UNVERIFIED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_IN_PROGRESS" | "DEPOSIT_CHECKPOINT_FAILED" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "ALL_AGENTS_EXCLUDED" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_NOTHING_TO_WITHDRAW" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_SWAP_INCOMPLETE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "WITHDRAW_RESERVATION_UNAVAILABLE" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "AGENT_APY_PERIOD_UNSUPPORTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "SWAP_DISABLED" | "SWAP_RATE_LIMITED" | "SWAP_REQUEST_FAILED" | "SWAP_QUOTE_FAILED" | "SWAP_UNSUPPORTED_PAIR" | "SWAP_APPROVAL_REQUIRED" | "SWAP_BELOW_DEPOSIT_MINIMUM" | "SWAP_DEPOSIT_PENDING" | "SWAP_WALLET_PROMPT_TIMEOUT" | "SWAP_INSUFFICIENT_GAS" | "SWAP_NATIVE_UNSUPPORTED" | "SWAP_ORDER_EXPIRED" | "SWAP_ORDER_REFUNDED" | "SWAP_ORDER_CANCELLED" | "SWAP_ORDER_NOT_FOUND" | "WITHDRAW_ARRIVAL_TIMEOUT" | "WITHDRAW_SWAP_FAILED" | "BALANCE_ALL_FAILED" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "POOL_CATALOG_UNSUPPORTED" | "POOL_SELECTION_UNSUPPORTED" | "POOL_SELECTION_NOT_APPLIED" | "POOL_SELECTION_RULE_LIMIT" | "VALIDATION_INVALID_DAYS";
|
|
1797
|
+
type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "AGENT_ACTIVATION_BLOCKED" | "AGENT_ACCOUNT_NOT_OWNEY" | "YIELDSEEKER_AGENT_MISSING" | "YIELDSEEKER_AGENT_CLOSED" | "YIELDSEEKER_SLOT_UNAVAILABLE" | "YIELDSEEKER_WALLET_UNVERIFIED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_IN_PROGRESS" | "DEPOSIT_CHECKPOINT_FAILED" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "ALL_AGENTS_EXCLUDED" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_NOTHING_TO_WITHDRAW" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_SWAP_INCOMPLETE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "WITHDRAW_RESERVATION_UNAVAILABLE" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "AGENT_APY_PERIOD_UNSUPPORTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "SWAP_DISABLED" | "SWAP_RATE_LIMITED" | "SWAP_REQUEST_FAILED" | "SWAP_QUOTE_FAILED" | "SWAP_UNSUPPORTED_PAIR" | "SWAP_APPROVAL_REQUIRED" | "SWAP_BELOW_DEPOSIT_MINIMUM" | "SWAP_DEPOSIT_PENDING" | "SWAP_WALLET_PROMPT_TIMEOUT" | "SWAP_INSUFFICIENT_GAS" | "SWAP_NATIVE_UNSUPPORTED" | "SWAP_ORDER_EXPIRED" | "SWAP_ORDER_REFUNDED" | "SWAP_ORDER_CANCELLED" | "SWAP_ORDER_NOT_FOUND" | "WITHDRAW_ARRIVAL_TIMEOUT" | "WITHDRAW_SWAP_FAILED" | "BALANCE_ALL_FAILED" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "POOL_CATALOG_UNSUPPORTED" | "POOL_SELECTION_UNSUPPORTED" | "POOL_SELECTION_NOT_APPLIED" | "POOL_SELECTION_RULE_LIMIT" | "POOL_SELECTION_REQUIRED" | "VALIDATION_INVALID_DAYS";
|
|
1790
1798
|
declare class OwneyError extends Error {
|
|
1791
1799
|
readonly code: OwneyErrorCode;
|
|
1792
1800
|
readonly details?: Record<string, unknown>;
|
|
@@ -1957,6 +1965,7 @@ declare class OwneySDK {
|
|
|
1957
1965
|
* withdraw, but they are excluded from new deposits / activations.
|
|
1958
1966
|
*/
|
|
1959
1967
|
private disabledAgents;
|
|
1968
|
+
private readonly accountRefusedListeners;
|
|
1960
1969
|
/**
|
|
1961
1970
|
* Agents whose sign-in the user cancelled this session (the wallet rejected
|
|
1962
1971
|
* the prompt), keyed by chain. Until the app ends the session they are read
|
|
@@ -2050,6 +2059,14 @@ declare class OwneySDK {
|
|
|
2050
2059
|
* a later sample is skipped once the wallet disconnects or changes.
|
|
2051
2060
|
*/
|
|
2052
2061
|
private ledgerProviderSamples;
|
|
2062
|
+
/**
|
|
2063
|
+
* Listens for an agent refusing the connected wallet because its provider
|
|
2064
|
+
* account was not created through Owney (`AGENT_ACCOUNT_NOT_OWNEY`). Fires
|
|
2065
|
+
* each time an agent maps such a refusal. Returns the unsubscribe function.
|
|
2066
|
+
*/
|
|
2067
|
+
onAccountRefused(listener: (agentId: AgentId) => void): () => void;
|
|
2068
|
+
/** Wires the optional hooks the SDK offers an agent. */
|
|
2069
|
+
private attachAgentHooks;
|
|
2053
2070
|
/**
|
|
2054
2071
|
* Funding-ledger read access handed to agents for earnings holds. Reads only
|
|
2055
2072
|
* for the connected owner; null otherwise and on any failure.
|
|
@@ -3190,6 +3207,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3190
3207
|
private readonly agentContexts;
|
|
3191
3208
|
private readonly walletContexts;
|
|
3192
3209
|
private readonly agentAccountReads;
|
|
3210
|
+
private readonly sessionAgents;
|
|
3193
3211
|
private readonly reportedAccounts;
|
|
3194
3212
|
private readonly missingSlots;
|
|
3195
3213
|
private readonly rethrownSlotFailures;
|
|
@@ -3223,6 +3241,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3223
3241
|
private readonly movementEpochs;
|
|
3224
3242
|
private readonly settlementChecks;
|
|
3225
3243
|
private ledgerAccess?;
|
|
3244
|
+
private accountRefusedListener?;
|
|
3226
3245
|
private readonly ledgerReads;
|
|
3227
3246
|
/** contextKey -> movements this instance started settling (by tx hash) and how they refresh:
|
|
3228
3247
|
* awaiting the ledger, refreshed when ready (ledger), or on the timed backoff (legacy). */
|
|
@@ -3261,8 +3280,9 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3261
3280
|
* - closed (`deactivatedDate` set): reactivates it, re-reads the wallet, and
|
|
3262
3281
|
* continues only when it is now open with the same address. Only the
|
|
3263
3282
|
* verified record's agent is reopened: any other closed agent (a
|
|
3264
|
-
* superseded-wallet match, or
|
|
3265
|
-
* when the accounts could not be read)
|
|
3283
|
+
* superseded-wallet match, or the agent this session created or adopted
|
|
3284
|
+
* before its record exists, also when the accounts could not be read)
|
|
3285
|
+
* refuses without a request;
|
|
3266
3286
|
* - anything else refuses with nothing sent, before any progress event,
|
|
3267
3287
|
* signature or callback. Every refusal carries `notSubmitted` and
|
|
3268
3288
|
* `safeToFallback: false`, so no paid fallback runs.
|
|
@@ -3353,6 +3373,13 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3353
3373
|
}) => void): Promise<DepositNotice>;
|
|
3354
3374
|
/** One `deposit-made` call. A failure that may pass on its own carries the wait before the next try. */
|
|
3355
3375
|
private sendDepositNotice;
|
|
3376
|
+
/**
|
|
3377
|
+
* Tells Yieldseeker (`deposit-made`) after a pool save, so the agent runs
|
|
3378
|
+
* now and rebalances money already in a vault the list no longer allows.
|
|
3379
|
+
* Up to DEPOSIT_NOTICE_ATTEMPTS calls in all, waiting between them only
|
|
3380
|
+
* after a failure that may pass; stops when the session ends. Never throws.
|
|
3381
|
+
*/
|
|
3382
|
+
private rebalanceAfterPoolSave;
|
|
3356
3383
|
/**
|
|
3357
3384
|
* When Yieldseeker may move funds again after this agent wallet's last
|
|
3358
3385
|
* confirmed withdrawal, if that is still ahead; null when there was none in
|
|
@@ -3409,13 +3436,11 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3409
3436
|
*
|
|
3410
3437
|
* - Only Base entries are ours. An asset with no picks whose entries showed
|
|
3411
3438
|
* no vault is skipped and nothing is sent.
|
|
3439
|
+
* - None picked (vaults shown) for any asset: every agent keeps at least one
|
|
3440
|
+
* pool (2026-11-11), so the whole save throws POOL_SELECTION_REQUIRED
|
|
3441
|
+
* before anything is written, for any asset.
|
|
3412
3442
|
* - Some vaults picked: the managed list names them. Saving it again
|
|
3413
3443
|
* replaces it, so there is only ever one.
|
|
3414
|
-
* - None picked (vaults shown): the managed list names no vault, and the
|
|
3415
|
-
* rules must read back as an empty allow-list. Yieldseeker then keeps the
|
|
3416
|
-
* agent's money out of every vault, as Zyfai does with an empty pool list,
|
|
3417
|
-
* and the next Pools step reads "none". Only an agent that already exists
|
|
3418
|
-
* is written: one is never created just to hold "none".
|
|
3419
3444
|
* - Every vault picked: the managed list is deleted, and no allow-list may
|
|
3420
3445
|
* remain, so vaults Yieldseeker adds later are allowed too.
|
|
3421
3446
|
* - A free-text allow-list we saved before the managed list existed is
|
|
@@ -3440,7 +3465,8 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3440
3465
|
private deleteLegacyPoolMemories;
|
|
3441
3466
|
/**
|
|
3442
3467
|
* `<address> (<name>)` for each pick, under the prefix. An unnamed address
|
|
3443
|
-
* has no brackets.
|
|
3468
|
+
* has no brackets. There is always at least one pick (setPoolSelection
|
|
3469
|
+
* refuses a save with none).
|
|
3444
3470
|
*/
|
|
3445
3471
|
private poolMemoryContent;
|
|
3446
3472
|
/** Undo a failed save of the managed list. Never throws: the caller reports the save's own failure. */
|
|
@@ -3507,8 +3533,9 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3507
3533
|
private listAgents;
|
|
3508
3534
|
/**
|
|
3509
3535
|
* The routing API's stored accounts for owner+chain, read once per session.
|
|
3510
|
-
* Resolves null when unavailable
|
|
3511
|
-
*
|
|
3536
|
+
* Resolves null when unavailable and never rejects; callers then refuse
|
|
3537
|
+
* (AGENT_ACCOUNTS_UNAVAILABLE) and create nothing. A failure is not kept:
|
|
3538
|
+
* concurrent callers share the in-flight read, and the next call reads again.
|
|
3512
3539
|
*/
|
|
3513
3540
|
private agentAccounts;
|
|
3514
3541
|
/** Yieldseeker accounts for one slot (returned addresses are compared lowercase). */
|
|
@@ -3591,11 +3618,15 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3591
3618
|
* 1. the listed fitting agent whose wallet is the verified account's wallet,
|
|
3592
3619
|
* whatever its name; the stored agentId is only a hint;
|
|
3593
3620
|
* 2. else a listed fitting agent whose wallet is a superseded account's wallet;
|
|
3594
|
-
* 3. else
|
|
3595
|
-
*
|
|
3596
|
-
*
|
|
3597
|
-
*
|
|
3598
|
-
*
|
|
3621
|
+
* 3. else, with a verified account, throw YIELDSEEKER_AGENT_MISSING (never
|
|
3622
|
+
* create);
|
|
3623
|
+
* 4. else, with no record at all, the listed agent this session created or
|
|
3624
|
+
* adopted for the slot (sessionAgents); without one, undefined (the
|
|
3625
|
+
* caller creates an agent named "owney"). An agent is never picked by
|
|
3626
|
+
* its name: only our records, and this session's own create, say which
|
|
3627
|
+
* agents are Owney's.
|
|
3628
|
+
* Without the account records (`null`: the read failed) nothing can be
|
|
3629
|
+
* known, so the call is refused and nothing is created.
|
|
3599
3630
|
* Steps 1 and 2 share one search of at most YIELDSEEKER_WALLET_MATCH_LIMIT
|
|
3600
3631
|
* wallet reads. The account report then records the selected wallet; the
|
|
3601
3632
|
* server marks it superseded when it differs from the verified wallet.
|
|
@@ -3628,7 +3659,12 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3628
3659
|
private ensureAgent;
|
|
3629
3660
|
private findAgent;
|
|
3630
3661
|
private resolveAgent;
|
|
3631
|
-
/**
|
|
3662
|
+
/**
|
|
3663
|
+
* Create the slot's agent, named "owney". Only reached when the slot has no
|
|
3664
|
+
* account record and no agent this session made; the created agent is
|
|
3665
|
+
* remembered for the session (sessionAgents) so reads select it before its
|
|
3666
|
+
* record exists.
|
|
3667
|
+
*/
|
|
3632
3668
|
private createAgent;
|
|
3633
3669
|
/**
|
|
3634
3670
|
* The routing create lock refused the create: another tab or app owns or is
|
|
@@ -3664,6 +3700,7 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3664
3700
|
private loadActivityContext;
|
|
3665
3701
|
private loadPortfolioParts;
|
|
3666
3702
|
private deployAgent;
|
|
3703
|
+
setAccountRefusedListener(listener: (() => void) | undefined): void;
|
|
3667
3704
|
setFundingLedgerAccess(access: AgentFundingLedgerAccess | undefined): void;
|
|
3668
3705
|
private historyKey;
|
|
3669
3706
|
/** Funding-ledger rows for this slot, cached 15 s. Never throws: null on any failure. */
|
|
@@ -3733,7 +3770,6 @@ declare class YieldseekerAgent implements IAgent {
|
|
|
3733
3770
|
private waitForReceipt;
|
|
3734
3771
|
private assertTransaction;
|
|
3735
3772
|
private assertAgent;
|
|
3736
|
-
private isOwneyAgent;
|
|
3737
3773
|
private assetForAgent;
|
|
3738
3774
|
private isTransactionHash;
|
|
3739
3775
|
private assertChain;
|