@aephia/atlas-kit 0.5.0 → 0.6.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.
- package/README.md +38 -27
- package/dist/cargo/index.d.ts +1 -0
- package/dist/cargo/index.d.ts.map +1 -1
- package/dist/cargo/index.js +1 -0
- package/dist/cargo/index.js.map +1 -1
- package/dist/claim-stakes/actions/index.d.ts +393 -0
- package/dist/claim-stakes/actions/index.d.ts.map +1 -0
- package/dist/claim-stakes/actions/index.js +1747 -0
- package/dist/claim-stakes/actions/index.js.map +1 -0
- package/dist/claim-stakes/index.d.ts +64 -0
- package/dist/claim-stakes/index.d.ts.map +1 -1
- package/dist/claim-stakes/index.js +49 -0
- package/dist/claim-stakes/index.js.map +1 -1
- package/dist/client/context.d.ts.map +1 -1
- package/dist/client/context.js +2 -1
- package/dist/client/context.js.map +1 -1
- package/dist/client/errors.d.ts +12 -3
- package/dist/client/errors.d.ts.map +1 -1
- package/dist/client/errors.js +11 -0
- package/dist/client/errors.js.map +1 -1
- package/dist/client/index.d.ts +2 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/lifecycle.d.ts +2 -0
- package/dist/client/lifecycle.d.ts.map +1 -1
- package/dist/client/lifecycle.js +31 -0
- package/dist/client/lifecycle.js.map +1 -1
- package/dist/combat/actions/index.d.ts +239 -0
- package/dist/combat/actions/index.d.ts.map +1 -0
- package/dist/combat/actions/index.js +1146 -0
- package/dist/combat/actions/index.js.map +1 -0
- package/dist/crafting/actions/index.d.ts +140 -0
- package/dist/crafting/actions/index.d.ts.map +1 -0
- package/dist/crafting/actions/index.js +728 -0
- package/dist/crafting/actions/index.js.map +1 -0
- package/dist/crafting/index.d.ts +74 -8
- package/dist/crafting/index.d.ts.map +1 -1
- package/dist/crafting/index.js +55 -9
- package/dist/crafting/index.js.map +1 -1
- package/dist/fleets/actions/index.d.ts +5 -4
- package/dist/fleets/actions/index.d.ts.map +1 -1
- package/dist/fleets/actions/index.js +85 -58
- package/dist/fleets/actions/index.js.map +1 -1
- package/dist/fleets/index.d.ts +1 -0
- package/dist/fleets/index.d.ts.map +1 -1
- package/dist/fleets/index.js +1 -0
- package/dist/fleets/index.js.map +1 -1
- package/dist/index.d.ts +13 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -2
- package/dist/index.js.map +1 -1
- package/dist/internal/c4/claim-stake-building-definitions.d.ts +50 -0
- package/dist/internal/c4/claim-stake-building-definitions.d.ts.map +1 -0
- package/dist/internal/c4/claim-stake-building-definitions.js +56 -0
- package/dist/internal/c4/claim-stake-building-definitions.js.map +1 -0
- package/dist/internal/c4/claim-stake-configuration.d.ts +17 -0
- package/dist/internal/c4/claim-stake-configuration.d.ts.map +1 -0
- package/dist/internal/c4/claim-stake-configuration.js +47 -0
- package/dist/internal/c4/claim-stake-configuration.js.map +1 -0
- package/dist/internal/c4/claim-stake-definitions.d.ts +37 -0
- package/dist/internal/c4/claim-stake-definitions.d.ts.map +1 -0
- package/dist/internal/c4/claim-stake-definitions.js +77 -0
- package/dist/internal/c4/claim-stake-definitions.js.map +1 -0
- package/dist/internal/c4/fleet.d.ts.map +1 -1
- package/dist/internal/c4/fleet.js +2 -102
- package/dist/internal/c4/fleet.js.map +1 -1
- package/dist/internal/c4/game-definition-layout.d.ts +11 -0
- package/dist/internal/c4/game-definition-layout.d.ts.map +1 -0
- package/dist/internal/c4/game-definition-layout.js +32 -0
- package/dist/internal/c4/game-definition-layout.js.map +1 -0
- package/dist/internal/c4/game.d.ts +13 -1
- package/dist/internal/c4/game.d.ts.map +1 -1
- package/dist/internal/c4/game.js +19 -37
- package/dist/internal/c4/game.js.map +1 -1
- package/dist/internal/c4/profile-faction.d.ts +6 -0
- package/dist/internal/c4/profile-faction.d.ts.map +1 -1
- package/dist/internal/c4/profile-faction.js +22 -1
- package/dist/internal/c4/profile-faction.js.map +1 -1
- package/dist/internal/c4/ship-stats.d.ts +5 -0
- package/dist/internal/c4/ship-stats.d.ts.map +1 -0
- package/dist/internal/c4/ship-stats.js +106 -0
- package/dist/internal/c4/ship-stats.js.map +1 -0
- package/dist/internal/c4/world.d.ts +23 -1
- package/dist/internal/c4/world.d.ts.map +1 -1
- package/dist/internal/c4/world.js +53 -1
- package/dist/internal/c4/world.js.map +1 -1
- package/dist/internal/crafting-process-state.d.ts +15 -0
- package/dist/internal/crafting-process-state.d.ts.map +1 -0
- package/dist/internal/crafting-process-state.js +12 -0
- package/dist/internal/crafting-process-state.js.map +1 -0
- package/dist/internal/planning/authorization-adapter.d.ts +74 -0
- package/dist/internal/planning/authorization-adapter.d.ts.map +1 -1
- package/dist/internal/planning/authorization-adapter.js +382 -0
- package/dist/internal/planning/authorization-adapter.js.map +1 -1
- package/dist/internal/read-meta.d.ts +39 -3
- package/dist/internal/read-meta.d.ts.map +1 -1
- package/dist/internal/read-meta.js +0 -10
- package/dist/internal/read-meta.js.map +1 -1
- package/dist/loyalty/actions/index.d.ts +40 -0
- package/dist/loyalty/actions/index.d.ts.map +1 -0
- package/dist/loyalty/actions/index.js +159 -0
- package/dist/loyalty/actions/index.js.map +1 -0
- package/dist/markets/actions/index.d.ts +100 -0
- package/dist/markets/actions/index.d.ts.map +1 -0
- package/dist/markets/actions/index.js +417 -0
- package/dist/markets/actions/index.js.map +1 -0
- package/dist/planning/assembly.d.ts +4 -0
- package/dist/planning/assembly.d.ts.map +1 -1
- package/dist/planning/assembly.js +13 -0
- package/dist/planning/assembly.js.map +1 -1
- package/dist/planning/composition.d.ts.map +1 -1
- package/dist/planning/composition.js +20 -1
- package/dist/planning/composition.js.map +1 -1
- package/dist/planning/execution.d.ts.map +1 -1
- package/dist/planning/execution.js +7 -4
- package/dist/planning/execution.js.map +1 -1
- package/dist/planning/index.d.ts +27 -8
- package/dist/planning/index.d.ts.map +1 -1
- package/dist/planning/index.js +57 -13
- package/dist/planning/index.js.map +1 -1
- package/dist/planning/simulation.d.ts.map +1 -1
- package/dist/planning/simulation.js +2 -1
- package/dist/planning/simulation.js.map +1 -1
- package/dist/registry/cargo.d.ts +10 -0
- package/dist/registry/cargo.d.ts.map +1 -0
- package/dist/registry/cargo.js +15 -0
- package/dist/registry/cargo.js.map +1 -0
- package/dist/registry/claim-stakes.d.ts +11 -0
- package/dist/registry/claim-stakes.d.ts.map +1 -0
- package/dist/registry/claim-stakes.js +15 -0
- package/dist/registry/claim-stakes.js.map +1 -0
- package/dist/registry/definition-section-snapshot.d.ts +42 -0
- package/dist/registry/definition-section-snapshot.d.ts.map +1 -0
- package/dist/registry/definition-section-snapshot.js +214 -0
- package/dist/registry/definition-section-snapshot.js.map +1 -0
- package/dist/registry/index.d.ts +114 -7
- package/dist/registry/index.d.ts.map +1 -1
- package/dist/registry/index.js +372 -101
- package/dist/registry/index.js.map +1 -1
- package/dist/registry/publication.d.ts +8 -0
- package/dist/registry/publication.d.ts.map +1 -0
- package/dist/registry/publication.js +10 -0
- package/dist/registry/publication.js.map +1 -0
- package/dist/registry/ship-stats-snapshot.d.ts +8 -0
- package/dist/registry/ship-stats-snapshot.d.ts.map +1 -0
- package/dist/registry/ship-stats-snapshot.js +154 -0
- package/dist/registry/ship-stats-snapshot.js.map +1 -0
- package/dist/world/index.d.ts +22 -1
- package/dist/world/index.d.ts.map +1 -1
- package/dist/world/index.js +24 -1
- package/dist/world/index.js.map +1 -1
- package/package.json +21 -1
package/README.md
CHANGED
|
@@ -58,29 +58,34 @@ const systems = await getStarSystems(ctx);
|
|
|
58
58
|
|
|
59
59
|
## Entry points
|
|
60
60
|
|
|
61
|
-
| Entry point
|
|
62
|
-
|
|
|
63
|
-
| `@aephia/atlas-kit`
|
|
64
|
-
| `@aephia/atlas-kit/bindings`
|
|
65
|
-
| `@aephia/atlas-kit/cargo`
|
|
66
|
-
| `@aephia/atlas-kit/cargo/actions`
|
|
67
|
-
| `@aephia/atlas-kit/claim-stakes`
|
|
68
|
-
| `@aephia/atlas-kit/
|
|
69
|
-
| `@aephia/atlas-kit/
|
|
70
|
-
| `@aephia/atlas-kit/
|
|
71
|
-
| `@aephia/atlas-kit/
|
|
72
|
-
| `@aephia/atlas-kit/
|
|
73
|
-
| `@aephia/atlas-kit/
|
|
74
|
-
| `@aephia/atlas-kit/
|
|
75
|
-
| `@aephia/atlas-kit/
|
|
76
|
-
| `@aephia/atlas-kit/
|
|
77
|
-
| `@aephia/atlas-kit/
|
|
78
|
-
| `@aephia/atlas-kit/
|
|
79
|
-
| `@aephia/atlas-kit/
|
|
80
|
-
| `@aephia/atlas-kit/
|
|
81
|
-
| `@aephia/atlas-kit/
|
|
82
|
-
| `@aephia/atlas-kit/
|
|
83
|
-
| `@aephia/atlas-kit/
|
|
61
|
+
| Entry point | Purpose |
|
|
62
|
+
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
63
|
+
| `@aephia/atlas-kit` | Loaded traversal across selected gameplay domains |
|
|
64
|
+
| `@aephia/atlas-kit/bindings` | Raw generated C4 clients as an explicit escape hatch |
|
|
65
|
+
| `@aephia/atlas-kit/cargo` | Cargo definitions, pods, inventory, and capacity |
|
|
66
|
+
| `@aephia/atlas-kit/cargo/actions` | Fleet/Starbase and within-Fleet cargo transfer planning |
|
|
67
|
+
| `@aephia/atlas-kit/claim-stakes` | Claim Stake reads, discovery, lifecycle, and production |
|
|
68
|
+
| `@aephia/atlas-kit/claim-stakes/actions` | Address-only Claim Stake placement, building-design planning, rent top-up, Fleet-transfer start and recovery, finalization, cancellation, and deconstruction |
|
|
69
|
+
| `@aephia/atlas-kit/client` | Context, cache, provenance, subscriptions, and errors |
|
|
70
|
+
| `@aephia/atlas-kit/combat` | Combat configuration, Fleet combat state, Loot, and Outlaws |
|
|
71
|
+
| `@aephia/atlas-kit/combat/actions` | Address-only owned-Fleet combat stimulant, singleton Fleet-attack, and Loot retrieval planning |
|
|
72
|
+
| `@aephia/atlas-kit/crafting` | Recipes, Crafting Habs, Processes, and production state |
|
|
73
|
+
| `@aephia/atlas-kit/crafting/actions` | Address-only Crafting Process lifecycle planning |
|
|
74
|
+
| `@aephia/atlas-kit/factions` | Faction identity, economics, diplomacy, and territory |
|
|
75
|
+
| `@aephia/atlas-kit/fleets` | Fleets, composition, movement state, and relationships |
|
|
76
|
+
| `@aephia/atlas-kit/fleets/actions` | Inspectable Fleet movement and arrival-settlement planners |
|
|
77
|
+
| `@aephia/atlas-kit/identity` | Wallet, Profile, Character, progression, and research reads |
|
|
78
|
+
| `@aephia/atlas-kit/loyalty` | Loyalty epochs, contributions, banks, and lifecycle |
|
|
79
|
+
| `@aephia/atlas-kit/loyalty/actions` | Address-only full-balance Loyalty ATLAS claim planning |
|
|
80
|
+
| `@aephia/atlas-kit/markets` | Local Market orders, maker state, and discovery |
|
|
81
|
+
| `@aephia/atlas-kit/markets/actions` | Address-only Local Market order, cancellation, and filled-escrow withdrawal planning |
|
|
82
|
+
| `@aephia/atlas-kit/mining` | Deposits, active mining, extraction, and cargo outputs |
|
|
83
|
+
| `@aephia/atlas-kit/planning` | Plans/PlanSequences, assembly, signer-free simulation, and execution |
|
|
84
|
+
| `@aephia/atlas-kit/scanning` | Scan patterns, cooldowns, stats, and Character state |
|
|
85
|
+
| `@aephia/atlas-kit/rewards` | ATLAS reward configuration, treasuries, and commitments |
|
|
86
|
+
| `@aephia/atlas-kit/starbases` | Player-local Starbase state, facilities, and upgrades |
|
|
87
|
+
| `@aephia/atlas-kit/starbases/actions` | Address-only StarbasePlayer registration planning |
|
|
88
|
+
| `@aephia/atlas-kit/world` | Game, regions, systems, bodies, and world projections |
|
|
84
89
|
|
|
85
90
|
## Scope and guarantees
|
|
86
91
|
|
|
@@ -91,11 +96,17 @@ const systems = await getStarSystems(ctx);
|
|
|
91
96
|
a typed outcome, and invalidates affected cache entries only on confirmed
|
|
92
97
|
success. No signer or key material is retained by the context. The Fleet
|
|
93
98
|
actions entries plan all five bounded movement transitions, Fleet arrival
|
|
94
|
-
settlement,
|
|
99
|
+
settlement, focused cargo and Starbase actions, Crafting Process
|
|
100
|
+
start/completion/cancellation, Local Market order
|
|
101
|
+
placement/cancellation/filled-escrow withdrawal, one owned Fleet's combat
|
|
102
|
+
stimulant application, singleton Fleet-on-Fleet and Fleet-on-Starbase attacks,
|
|
103
|
+
Loot retrieval, and full-balance Loyalty ATLAS claims without write RPC;
|
|
95
104
|
`simulatePlan` accepts only an address-valued assembly policy and never
|
|
96
|
-
invokes a signer. Remaining capability planners do not ship yet.
|
|
97
|
-
|
|
98
|
-
|
|
105
|
+
invokes a signer. Remaining accepted W3 capability planners do not ship yet.
|
|
106
|
+
Combat permission, range, randomness, rewards, damage, stimulant stacking, and
|
|
107
|
+
final outcomes remain chain-authoritative. Treat every unknown outcome as
|
|
108
|
+
possibly submitted and never retry it automatically; execution can incur fees
|
|
109
|
+
or move assets.
|
|
99
110
|
- **Fail-closed Plan sequences.** A `PlanSequence` is a non-atomic itinerary of
|
|
100
111
|
caller-owned lazy steps. Capability callbacks report `waiting` or return one
|
|
101
112
|
freshly prepared Plan only when reached; every transaction needs fresh
|
package/dist/cargo/index.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext } from '../client/index.js';
|
|
2
2
|
import { type ResolvedFleetCargoInventory } from '../internal/cargo.js';
|
|
3
3
|
import { type CargoDefinitionSummary, type DefinitionLookupOptions } from '../registry/index.js';
|
|
4
|
+
export { listCargoDefinitions } from '../registry/index.js';
|
|
4
5
|
export type { CargoCapacity, CargoInventoryItem, CargoPodInventory, } from '../internal/cargo.js';
|
|
5
6
|
/** Stable cargo definition resolved lazily from the configured Game registry.
|
|
6
7
|
* @example
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CACvD,2BAA2B,EAC3B,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAwED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CACvD,2BAA2B,EAC3B,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAwED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAUtC;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}
|
package/dist/cargo/index.js
CHANGED
|
@@ -6,6 +6,7 @@ import { attachJsonSerialization } from '../internal/json.js';
|
|
|
6
6
|
import { attachReadMeta, readMeta } from '../internal/read-meta.js';
|
|
7
7
|
import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
|
|
8
8
|
import { resolveCargo, } from '../registry/index.js';
|
|
9
|
+
export { listCargoDefinitions } from '../registry/index.js';
|
|
9
10
|
const FLEET_INVENTORIES = new WeakMap();
|
|
10
11
|
function directMetadata(envelope) {
|
|
11
12
|
return {
|
package/dist/cargo/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,SAAS,GAQV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EACL,YAAY,GAGb,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cargo/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
import { type Address } from '@solana/kit';
|
|
2
|
+
import type { SageContext } from '../../client/contracts.js';
|
|
3
|
+
import type { EntityRef } from '../../client/refs.js';
|
|
4
|
+
import { type WorldClaimStakeGroupData, type WorldFixedValue, type WorldPlanetResourceData } from '../../internal/c4/world.js';
|
|
5
|
+
import { type PlanAuthorization } from '../../internal/planning/authorization-adapter.js';
|
|
6
|
+
import { type Plan } from '../../planning/index.js';
|
|
7
|
+
import type { ResolvedFleetAccountData } from '../../internal/fleet.js';
|
|
8
|
+
import type { ClaimStakeSnapshot } from '../index.js';
|
|
9
|
+
export type { PlanAuthorization };
|
|
10
|
+
interface PlanetDetails {
|
|
11
|
+
readonly claimStakePlots: readonly (readonly number[])[];
|
|
12
|
+
readonly baseClaimStakeRentRate: readonly (readonly WorldFixedValue[])[];
|
|
13
|
+
readonly baseClaimStakePlacementFee: readonly (readonly WorldFixedValue[])[];
|
|
14
|
+
readonly resources: readonly WorldPlanetResourceData[];
|
|
15
|
+
readonly providedTags: readonly number[];
|
|
16
|
+
readonly claimedPlotsUnsizedLength: number;
|
|
17
|
+
readonly claimedPlots: readonly WorldClaimStakeGroupData[];
|
|
18
|
+
}
|
|
19
|
+
interface CelestialBodyCommonSnapshot {
|
|
20
|
+
readonly address: Address;
|
|
21
|
+
readonly game: Address;
|
|
22
|
+
readonly id: number;
|
|
23
|
+
readonly name: string;
|
|
24
|
+
readonly system: EntityRef<'starSystem'>;
|
|
25
|
+
readonly systemSequenceId: bigint;
|
|
26
|
+
}
|
|
27
|
+
type CelestialBodySnapshot = CelestialBodyCommonSnapshot & ({
|
|
28
|
+
readonly kind: 'planet';
|
|
29
|
+
readonly details: PlanetDetails;
|
|
30
|
+
} | {
|
|
31
|
+
readonly kind: 'asteroid';
|
|
32
|
+
readonly details: {
|
|
33
|
+
readonly resources: readonly unknown[];
|
|
34
|
+
};
|
|
35
|
+
});
|
|
36
|
+
interface StarbasePlayerSnapshot {
|
|
37
|
+
readonly kind: 'starbasePlayer';
|
|
38
|
+
readonly address: Address;
|
|
39
|
+
readonly playerProfile: EntityRef<'profile'>;
|
|
40
|
+
readonly system: EntityRef<'starSystem'>;
|
|
41
|
+
readonly character: EntityRef<'character'>;
|
|
42
|
+
readonly availableCrew: number;
|
|
43
|
+
readonly cargo: {
|
|
44
|
+
readonly items: readonly {
|
|
45
|
+
readonly id: number;
|
|
46
|
+
readonly name: string;
|
|
47
|
+
readonly quantityRaw: bigint;
|
|
48
|
+
}[];
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
/** Exact address-only inputs for placing one Claim Stake and its bundled hub.
|
|
52
|
+
*
|
|
53
|
+
* `initialRentAmount` is a positive raw unsigned-u64 amount. `claimStake` is a
|
|
54
|
+
* new caller-created signer whose public address is retained without key
|
|
55
|
+
* material.
|
|
56
|
+
*
|
|
57
|
+
* @example
|
|
58
|
+
* ```ts
|
|
59
|
+
* declare const authorization: PlanAuthorization;
|
|
60
|
+
* declare const claimStake: Address;
|
|
61
|
+
* const options: PlanPlaceClaimStakeOptions = {
|
|
62
|
+
* authorization,
|
|
63
|
+
* claimStake,
|
|
64
|
+
* claimStakeDefinitionId: 2,
|
|
65
|
+
* hubBuildingId: 21,
|
|
66
|
+
* initialRentAmount: 500_000_000n,
|
|
67
|
+
* };
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
export interface PlanPlaceClaimStakeOptions {
|
|
71
|
+
readonly authorization: PlanAuthorization;
|
|
72
|
+
readonly claimStake: Address;
|
|
73
|
+
readonly claimStakeDefinitionId: number;
|
|
74
|
+
readonly hubBuildingId: number;
|
|
75
|
+
readonly initialRentAmount: bigint;
|
|
76
|
+
}
|
|
77
|
+
/** One bounded Claim Stake building addition or removal.
|
|
78
|
+
*
|
|
79
|
+
* The positive `quantity` is translated to the generated instruction's signed
|
|
80
|
+
* delta. Each building id may appear only once in a plan.
|
|
81
|
+
*
|
|
82
|
+
* @example
|
|
83
|
+
* ```ts
|
|
84
|
+
* const change: ClaimStakeBuildingChange = {
|
|
85
|
+
* buildingId: 9,
|
|
86
|
+
* kind: 'add',
|
|
87
|
+
* quantity: 2,
|
|
88
|
+
* };
|
|
89
|
+
* ```
|
|
90
|
+
*/
|
|
91
|
+
export type ClaimStakeBuildingChange = {
|
|
92
|
+
readonly buildingId: number;
|
|
93
|
+
readonly kind: 'add';
|
|
94
|
+
readonly quantity: number;
|
|
95
|
+
} | {
|
|
96
|
+
readonly buildingId: number;
|
|
97
|
+
readonly kind: 'remove';
|
|
98
|
+
readonly quantity: number;
|
|
99
|
+
};
|
|
100
|
+
/** Exact inputs for changing one owned Claim Stake's building design.
|
|
101
|
+
*
|
|
102
|
+
* `buildingChanges` is a non-empty dense list with one positive add/remove
|
|
103
|
+
* quantity per building id.
|
|
104
|
+
*
|
|
105
|
+
* @example
|
|
106
|
+
* ```ts
|
|
107
|
+
* declare const authorization: PlanAuthorization;
|
|
108
|
+
* const options: PlanClaimStakeBuildingChangesOptions = {
|
|
109
|
+
* authorization,
|
|
110
|
+
* buildingChanges: [{ buildingId: 9, kind: 'add', quantity: 2 }],
|
|
111
|
+
* };
|
|
112
|
+
* ```
|
|
113
|
+
*/
|
|
114
|
+
export interface PlanClaimStakeBuildingChangesOptions {
|
|
115
|
+
readonly authorization: PlanAuthorization;
|
|
116
|
+
readonly buildingChanges: readonly ClaimStakeBuildingChange[];
|
|
117
|
+
}
|
|
118
|
+
/** Exact inputs for finalizing one owned Claim Stake building design.
|
|
119
|
+
*
|
|
120
|
+
* @example
|
|
121
|
+
* ```ts
|
|
122
|
+
* declare const authorization: PlanAuthorization;
|
|
123
|
+
* const options: PlanFinalizeClaimStakeBuildingChangesOptions = {
|
|
124
|
+
* authorization,
|
|
125
|
+
* };
|
|
126
|
+
* ```
|
|
127
|
+
*/
|
|
128
|
+
export interface PlanFinalizeClaimStakeBuildingChangesOptions {
|
|
129
|
+
readonly authorization: PlanAuthorization;
|
|
130
|
+
}
|
|
131
|
+
/** Exact inputs for cancelling one owned Claim Stake building design.
|
|
132
|
+
*
|
|
133
|
+
* @example
|
|
134
|
+
* ```ts
|
|
135
|
+
* declare const authorization: PlanAuthorization;
|
|
136
|
+
* const options: PlanCancelClaimStakeBuildingChangesOptions = {
|
|
137
|
+
* authorization,
|
|
138
|
+
* };
|
|
139
|
+
* ```
|
|
140
|
+
*/
|
|
141
|
+
export interface PlanCancelClaimStakeBuildingChangesOptions {
|
|
142
|
+
readonly authorization: PlanAuthorization;
|
|
143
|
+
}
|
|
144
|
+
/** Exact inputs for deconstructing one owned active Claim Stake.
|
|
145
|
+
*
|
|
146
|
+
* @example
|
|
147
|
+
* ```ts
|
|
148
|
+
* declare const authorization: PlanAuthorization;
|
|
149
|
+
* const options: PlanDeconstructClaimStakeOptions = { authorization };
|
|
150
|
+
* ```
|
|
151
|
+
*/
|
|
152
|
+
export interface PlanDeconstructClaimStakeOptions {
|
|
153
|
+
readonly authorization: PlanAuthorization;
|
|
154
|
+
}
|
|
155
|
+
/** Exact inputs for topping up one owned placed Claim Stake's rent.
|
|
156
|
+
*
|
|
157
|
+
* `amount` is a positive raw unsigned-u64 amount, not a display ATLAS value.
|
|
158
|
+
*
|
|
159
|
+
* @example
|
|
160
|
+
* ```ts
|
|
161
|
+
* declare const authorization: PlanAuthorization;
|
|
162
|
+
* const options: PlanTopUpClaimStakeRentOptions = {
|
|
163
|
+
* amount: 500_000_000n,
|
|
164
|
+
* authorization,
|
|
165
|
+
* };
|
|
166
|
+
* ```
|
|
167
|
+
*/
|
|
168
|
+
export interface PlanTopUpClaimStakeRentOptions {
|
|
169
|
+
readonly amount: bigint;
|
|
170
|
+
readonly authorization: PlanAuthorization;
|
|
171
|
+
}
|
|
172
|
+
/** One exact raw cargo request for starting a Claim Stake Fleet transfer.
|
|
173
|
+
*
|
|
174
|
+
* @example
|
|
175
|
+
* ```ts
|
|
176
|
+
* const request: ClaimStakeFleetTransferCargoRequest = {
|
|
177
|
+
* cargoId: 3,
|
|
178
|
+
* amount: 25n,
|
|
179
|
+
* };
|
|
180
|
+
* ```
|
|
181
|
+
*/
|
|
182
|
+
export interface ClaimStakeFleetTransferCargoRequest {
|
|
183
|
+
readonly cargoId: number;
|
|
184
|
+
readonly amount: bigint;
|
|
185
|
+
}
|
|
186
|
+
/** Exact bidirectional cargo inputs for starting one Claim Stake Fleet transfer.
|
|
187
|
+
*
|
|
188
|
+
* `load` moves cargo from the Claim Stake to the Fleet; `unload` moves cargo
|
|
189
|
+
* from the Fleet to the Claim Stake. At least one list must contain a request,
|
|
190
|
+
* and each cargo id may appear only once across both dense lists.
|
|
191
|
+
*
|
|
192
|
+
* @example
|
|
193
|
+
* ```ts
|
|
194
|
+
* declare const authorization: PlanAuthorization;
|
|
195
|
+
* const options: PlanStartClaimStakeFleetTransferOptions = {
|
|
196
|
+
* authorization,
|
|
197
|
+
* load: [{ cargoId: 3, amount: 25n }],
|
|
198
|
+
* unload: [{ cargoId: 1, amount: 10n }],
|
|
199
|
+
* };
|
|
200
|
+
* ```
|
|
201
|
+
*/
|
|
202
|
+
export interface PlanStartClaimStakeFleetTransferOptions {
|
|
203
|
+
readonly authorization: PlanAuthorization;
|
|
204
|
+
readonly load: readonly ClaimStakeFleetTransferCargoRequest[];
|
|
205
|
+
readonly unload: readonly ClaimStakeFleetTransferCargoRequest[];
|
|
206
|
+
}
|
|
207
|
+
/** Exact inputs for recovering one provably stuck Claim Stake Fleet transfer.
|
|
208
|
+
*
|
|
209
|
+
* `atUnixSeconds` is an explicit non-negative Unix timestamp used to prove the
|
|
210
|
+
* transfer lock has elapsed. The planner never reads a local clock.
|
|
211
|
+
*
|
|
212
|
+
* @example
|
|
213
|
+
* ```ts
|
|
214
|
+
* declare const authorization: PlanAuthorization;
|
|
215
|
+
* const options: PlanRecoverClaimStakeFleetTransferOptions = {
|
|
216
|
+
* atUnixSeconds: 1_700_000_100n,
|
|
217
|
+
* authorization,
|
|
218
|
+
* };
|
|
219
|
+
* ```
|
|
220
|
+
*/
|
|
221
|
+
export interface PlanRecoverClaimStakeFleetTransferOptions {
|
|
222
|
+
readonly atUnixSeconds: bigint;
|
|
223
|
+
readonly authorization: PlanAuthorization;
|
|
224
|
+
}
|
|
225
|
+
interface FleetSnapshot extends Omit<ResolvedFleetAccountData, 'ownerProfile'> {
|
|
226
|
+
readonly kind: 'fleet';
|
|
227
|
+
readonly address: Address;
|
|
228
|
+
readonly ownerProfile: EntityRef<'profile'>;
|
|
229
|
+
toJSON(): unknown;
|
|
230
|
+
}
|
|
231
|
+
/** Plans placement of one Claim Stake with its exact bundled hub.
|
|
232
|
+
*
|
|
233
|
+
* The planner validates the configured Game/Profile/Character/System/Body
|
|
234
|
+
* graph, current catalog membership, known plot/cargo/crew availability, and
|
|
235
|
+
* absence of the caller-created Claim Stake account. It returns one inert Plan;
|
|
236
|
+
* permissions, placement races, rent arithmetic, and program capacity remain
|
|
237
|
+
* chain-authoritative.
|
|
238
|
+
*
|
|
239
|
+
* @example
|
|
240
|
+
* ```ts
|
|
241
|
+
* declare const ctx: SageContext;
|
|
242
|
+
* declare const body: CelestialBodySnapshot;
|
|
243
|
+
* declare const player: StarbasePlayerSnapshot;
|
|
244
|
+
* declare const options: PlanPlaceClaimStakeOptions;
|
|
245
|
+
* const plan = await planPlaceClaimStake(ctx, body, player, options);
|
|
246
|
+
* console.log(plan.describe());
|
|
247
|
+
* ```
|
|
248
|
+
*/
|
|
249
|
+
export declare function planPlaceClaimStake(ctx: SageContext, body: CelestialBodySnapshot, player: StarbasePlayerSnapshot, input: PlanPlaceClaimStakeOptions): Promise<Plan>;
|
|
250
|
+
/** Plans one exact set of additions/removals for an owned active/design Claim Stake.
|
|
251
|
+
*
|
|
252
|
+
* The planner verifies the fresh Claim Stake, definition sequences, canonical
|
|
253
|
+
* Profile/Character/Body/System/Starbase Player graph, optional
|
|
254
|
+
* FactionOwnership sidecar, building quantities, slots, crew, and known
|
|
255
|
+
* construction cargo. Rent synchronization and the final concurrent sequence
|
|
256
|
+
* race remain chain-authoritative.
|
|
257
|
+
*
|
|
258
|
+
* @example
|
|
259
|
+
* ```ts
|
|
260
|
+
* declare const ctx: SageContext;
|
|
261
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
262
|
+
* declare const options: PlanClaimStakeBuildingChangesOptions;
|
|
263
|
+
* const plan = await planClaimStakeBuildingChanges(ctx, stake, options);
|
|
264
|
+
* console.log(plan.describe());
|
|
265
|
+
* ```
|
|
266
|
+
*/
|
|
267
|
+
export declare function planClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanClaimStakeBuildingChangesOptions): Promise<Plan>;
|
|
268
|
+
/** Plans finalization of one owned Claim Stake building design.
|
|
269
|
+
*
|
|
270
|
+
* The planner requires a fresh design state, a coherent configured
|
|
271
|
+
* Game/Character/Planet/System/Starbase Player graph, the canonical
|
|
272
|
+
* CurrencyCache, and a known positive rent balance. Rent timing and the final
|
|
273
|
+
* crew/building validation remain chain-authoritative.
|
|
274
|
+
*
|
|
275
|
+
* @example
|
|
276
|
+
* ```ts
|
|
277
|
+
* declare const ctx: SageContext;
|
|
278
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
279
|
+
* declare const authorization: PlanAuthorization;
|
|
280
|
+
* const plan = await planFinalizeClaimStakeBuildingChanges(ctx, stake, {
|
|
281
|
+
* authorization,
|
|
282
|
+
* });
|
|
283
|
+
* // The program re-synchronizes rent at execution.
|
|
284
|
+
* console.log(plan.describe());
|
|
285
|
+
* ```
|
|
286
|
+
*/
|
|
287
|
+
export declare function planFinalizeClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanFinalizeClaimStakeBuildingChangesOptions): Promise<Plan>;
|
|
288
|
+
/** Plans cancellation of one owned Claim Stake building design.
|
|
289
|
+
*
|
|
290
|
+
* The planner requires a fresh design state and a coherent configured
|
|
291
|
+
* Game/Claim Stake/Planet/System/Starbase Player graph. The program
|
|
292
|
+
* re-synchronizes rent at execution and returns the Claim Stake to active
|
|
293
|
+
* state; rent arithmetic and concurrent state transitions remain
|
|
294
|
+
* chain-authoritative.
|
|
295
|
+
*
|
|
296
|
+
* @example
|
|
297
|
+
* ```ts
|
|
298
|
+
* declare const ctx: SageContext;
|
|
299
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
300
|
+
* declare const authorization: PlanAuthorization;
|
|
301
|
+
* const plan = await planCancelClaimStakeBuildingChanges(ctx, stake, {
|
|
302
|
+
* authorization,
|
|
303
|
+
* });
|
|
304
|
+
* console.log(plan.describe());
|
|
305
|
+
* ```
|
|
306
|
+
*/
|
|
307
|
+
export declare function planCancelClaimStakeBuildingChanges(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanCancelClaimStakeBuildingChangesOptions): Promise<Plan>;
|
|
308
|
+
/** Plans deconstruction of one owned active Claim Stake.
|
|
309
|
+
*
|
|
310
|
+
* The planner derives the current Planet chronology index and exact plot bucket
|
|
311
|
+
* from the Claim Stake definition tier and fresh Body plot matrix. The only
|
|
312
|
+
* remaining building must be the definition-compatible zero-cost bundled hub,
|
|
313
|
+
* which deconstruction discards.
|
|
314
|
+
* Rent settlement, cargo return, account closure, and concurrent races remain
|
|
315
|
+
* chain-authoritative; the Plan does not estimate a refund.
|
|
316
|
+
*
|
|
317
|
+
* @example
|
|
318
|
+
* ```ts
|
|
319
|
+
* declare const ctx: SageContext;
|
|
320
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
321
|
+
* declare const authorization: PlanAuthorization;
|
|
322
|
+
* const plan = await planDeconstructClaimStake(ctx, stake, { authorization });
|
|
323
|
+
* console.log(plan.describe());
|
|
324
|
+
* ```
|
|
325
|
+
*/
|
|
326
|
+
export declare function planDeconstructClaimStake(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanDeconstructClaimStakeOptions): Promise<Plan>;
|
|
327
|
+
/** Plans one exact raw rent top-up for an owned placed Claim Stake.
|
|
328
|
+
*
|
|
329
|
+
* The planner validates the fresh Claim Stake and its canonical
|
|
330
|
+
* Profile/Character/Planet/System/Starbase Player graph, plus the Character's
|
|
331
|
+
* known raw ATLAS balance. Permission checks, concurrent balance changes, rent
|
|
332
|
+
* arithmetic, and duration purchased remain chain-authoritative.
|
|
333
|
+
*
|
|
334
|
+
* @example
|
|
335
|
+
* ```ts
|
|
336
|
+
* declare const ctx: SageContext;
|
|
337
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
338
|
+
* declare const authorization: PlanAuthorization;
|
|
339
|
+
* const plan = await planTopUpClaimStakeRent(ctx, stake, {
|
|
340
|
+
* amount: 500_000_000n,
|
|
341
|
+
* authorization,
|
|
342
|
+
* });
|
|
343
|
+
* console.log(plan.describe());
|
|
344
|
+
* ```
|
|
345
|
+
*/
|
|
346
|
+
export declare function planTopUpClaimStakeRent(ctx: SageContext, stake: ClaimStakeSnapshot, input: PlanTopUpClaimStakeRentOptions): Promise<Plan>;
|
|
347
|
+
/** Plans the start of one Fleet transfer to an owned active Claim Stake.
|
|
348
|
+
*
|
|
349
|
+
* The planner validates the shared Profile/Game, idle Fleet with normalized
|
|
350
|
+
* crew, active Claim Stake, canonical Planet/System/Starbase Player graph,
|
|
351
|
+
* exact source balances, exact destination capacities, and an optional present
|
|
352
|
+
* FleetCrewBinding. The chain remains authoritative for range, duration,
|
|
353
|
+
* permission bits, concurrent state changes, and transfer arithmetic.
|
|
354
|
+
*
|
|
355
|
+
* @example
|
|
356
|
+
* ```ts
|
|
357
|
+
* declare const ctx: SageContext;
|
|
358
|
+
* declare const fleet: FleetSnapshot;
|
|
359
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
360
|
+
* declare const authorization: PlanAuthorization;
|
|
361
|
+
* const plan = await planStartClaimStakeFleetTransfer(ctx, fleet, stake, {
|
|
362
|
+
* authorization,
|
|
363
|
+
* load: [{ cargoId: 3, amount: 25n }],
|
|
364
|
+
* unload: [{ cargoId: 1, amount: 10n }],
|
|
365
|
+
* });
|
|
366
|
+
* console.log(plan.describe());
|
|
367
|
+
* ```
|
|
368
|
+
*/
|
|
369
|
+
export declare function planStartClaimStakeFleetTransfer(ctx: SageContext, fleet: FleetSnapshot, stake: ClaimStakeSnapshot, input: PlanStartClaimStakeFleetTransferOptions): Promise<Plan>;
|
|
370
|
+
/** Plans owner-authorized recovery of one provably non-executable Claim Stake transfer.
|
|
371
|
+
*
|
|
372
|
+
* Recovery is available only after the explicit transfer lock time and only
|
|
373
|
+
* when fresh Fleet/Claim Stake cargo and Game definition state proves a source
|
|
374
|
+
* shortfall, invalid queued cargo id, or destination overflow. An executable
|
|
375
|
+
* transfer is rejected so callers use the permissionless normal exit instead.
|
|
376
|
+
* Recovery returns the Fleet to idle without moving cargo or changing the
|
|
377
|
+
* Claim Stake.
|
|
378
|
+
*
|
|
379
|
+
* @example
|
|
380
|
+
* ```ts
|
|
381
|
+
* declare const ctx: SageContext;
|
|
382
|
+
* declare const fleet: FleetSnapshot;
|
|
383
|
+
* declare const stake: ClaimStakeSnapshot;
|
|
384
|
+
* declare const authorization: PlanAuthorization;
|
|
385
|
+
* const plan = await planRecoverClaimStakeFleetTransfer(ctx, fleet, stake, {
|
|
386
|
+
* atUnixSeconds: 1_700_000_100n,
|
|
387
|
+
* authorization,
|
|
388
|
+
* });
|
|
389
|
+
* console.log(plan.describe());
|
|
390
|
+
* ```
|
|
391
|
+
*/
|
|
392
|
+
export declare function planRecoverClaimStakeFleetTransfer(ctx: SageContext, fleet: FleetSnapshot, stake: ClaimStakeSnapshot, input: PlanRecoverClaimStakeFleetTransferOptions): Promise<Plan>;
|
|
393
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/claim-stakes/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAgCtD,OAAO,EAML,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAE7B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,UAAU,aAAa;IACrB,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACzD,QAAQ,CAAC,sBAAsB,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,0BAA0B,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC5D;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,KAAK,qBAAqB,GAAG,2BAA2B,GACtD,CACI;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC5D;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,CAAC;CAC9D,CACJ,CAAC;AAEJ,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,SAAS;YACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;SAC9B,EAAE,CAAC;KACL,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC/D;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,mCAAmC,EAAE,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,mCAAmC,EAAE,CAAC;CACjE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED,UAAU,aAAc,SAAQ,IAAI,CAAC,wBAAwB,EAAE,cAAc,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAufD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,IAAI,CAAC,CA6Rf;AA4DD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAocf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,4CAA4C,GAClD,OAAO,CAAC,IAAI,CAAC,CAyMf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,0CAA0C,GAChD,OAAO,CAAC,IAAI,CAAC,CA8Jf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAiSf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,IAAI,CAAC,CAiLf;AA0ED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA8Wf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kCAAkC,CACtD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,yCAAyC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAmQf"}
|