crafting/actions

Interfaces

PlanCancelCraftingProcessOptions

Defined in: packages/sage/src/crafting/actions/index.ts:138

Inputs for cancelling one unfinished Crafting Process.

atUnixSeconds is an explicit non-negative Unix timestamp used only for the deterministic local lifecycle check. Final inventory capacity, permissions, input and crew returns, and account closure remain chain-authoritative.

Example

declare const authorization: PlanAuthorization;
const options: PlanCancelCraftingProcessOptions = {
  authorization,
  atUnixSeconds: 1_700_001_000n,
};

Properties

atUnixSeconds

readonly atUnixSeconds: bigint;

Defined in: packages/sage/src/crafting/actions/index.ts:140

authorization

readonly authorization: PlanAuthorization;

Defined in: packages/sage/src/crafting/actions/index.ts:139

---

PlanCompleteCraftingProcessOptions

Defined in: packages/sage/src/crafting/actions/index.ts:116

Inputs for completing one Crafting Process.

atUnixSeconds is an explicit non-negative Unix timestamp used only for the deterministic local lifecycle check. Final permission, freshness, output capacity, XP, and account closure remain chain-authoritative.

Example

declare const authorization: PlanAuthorization;
const options: PlanCompleteCraftingProcessOptions = {
  authorization,
  atUnixSeconds: 1_700_004_000n,
};

Properties

atUnixSeconds

readonly atUnixSeconds: bigint;

Defined in: packages/sage/src/crafting/actions/index.ts:118

authorization

readonly authorization: PlanAuthorization;

Defined in: packages/sage/src/crafting/actions/index.ts:117

---

PlanStartCraftingProcessOptions

Defined in: packages/sage/src/crafting/actions/index.ts:91

Inputs for starting one exact Crafting Process.

quantity is a positive raw unsigned-u64 integer. numCrew is the exact unsigned-u32 crew count committed by the instruction. craftingProcess is the address of a new caller-created signer; planning retains only its address. Supply craftingHab when the Recipe requires or should use Hab production.

Example

declare const authorization: PlanAuthorization;
declare const craftingProcess: Address;
const options: PlanStartCraftingProcessOptions = {
  authorization,
  craftingProcess,
  quantity: 2n,
  numCrew: 6,
};

Properties

authorization

readonly authorization: PlanAuthorization;

Defined in: packages/sage/src/crafting/actions/index.ts:92

craftingHab?

readonly optional craftingHab?: CraftingHabSnapshot;

Defined in: packages/sage/src/crafting/actions/index.ts:96

craftingProcess

readonly craftingProcess: Address;

Defined in: packages/sage/src/crafting/actions/index.ts:93

numCrew

readonly numCrew: number;

Defined in: packages/sage/src/crafting/actions/index.ts:95

quantity

readonly quantity: bigint;

Defined in: packages/sage/src/crafting/actions/index.ts:94

Functions

planCancelCraftingProcess()

function planCancelCraftingProcess(
   ctx,
   process,
input): Promise<Plan>;

Defined in: packages/sage/src/crafting/actions/index.ts:1364

Plans cancellation of one unfinished Crafting Process without signing or writes.

The planner resolves and validates the Process account graph, requires Profile ownership, and rejects completed or destroyed-Starbase Process snapshots. Final inventory capacity, permissions, returned inputs and crew, and account closure remain chain-authoritative.

Parameters

Parameter	Type
ctx	SageContext
process	CraftingProcessSnapshot
input	PlanCancelCraftingProcessOptions

Returns

Promise<Plan>

Example

declare const ctx: SageContext;
declare const process: CraftingProcessSnapshot;
declare const options: PlanCancelCraftingProcessOptions;
const plan = await planCancelCraftingProcess(ctx, process, options);
console.log(plan.describe());

---

planCompleteCraftingProcess()

function planCompleteCraftingProcess(
   ctx,
   process,
input): Promise<Plan>;

Defined in: packages/sage/src/crafting/actions/index.ts:1053

Plans completion of one Crafting Process without signing, simulation, or writes.

The planner resolves and validates the Process account graph, requires Profile ownership, and checks the translated lifecycle at the caller-provided Unix timestamp. Output capacity, permissions, XP, closure, and final execution freshness remain chain-authoritative.

Parameters

Parameter	Type
ctx	SageContext
process	CraftingProcessSnapshot
input	PlanCompleteCraftingProcessOptions

Returns

Promise<Plan>

Example

declare const ctx: SageContext;
declare const process: CraftingProcessSnapshot;
declare const options: PlanCompleteCraftingProcessOptions;
const plan = await planCompleteCraftingProcess(ctx, process, options);
console.log(plan.describe());

---

planStartCraftingProcess()

function planStartCraftingProcess(
   ctx,
   recipe,
   player,
input): Promise<Plan>;

Defined in: packages/sage/src/crafting/actions/index.ts:615

Plans one Crafting Process start without signing, simulation, or writes.

The planner validates the loaded Recipe and Starbase Player, optional Hab, known ingredient balances, available crew, and exact whole-account state. It returns one inert Plan whose two required signer roles are bound only during execution.

Parameters

Parameter	Type
ctx	SageContext
recipe	RecipeSnapshot
player	StarbasePlayerSnapshot
input	PlanStartCraftingProcessOptions

Returns

Promise<Plan>

Example

declare const ctx: SageContext;
declare const recipe: RecipeSnapshot;
declare const player: StarbasePlayerSnapshot;
declare const options: PlanStartCraftingProcessOptions;
const plan = await planStartCraftingProcess(ctx, recipe, player, options);
console.log(plan.describe());

References

PlanAuthorization

Re-exports PlanAuthorization