# fleets
Documentation: next (source: develop).

Install the preview: `pnpm add @aephia/atlas-kit@next`. These docs follow develop and may include changes not yet published to npm.

Markdown source of https://develop.atlas-kit-docs.pages.dev/reference/fleets/ — see https://develop.atlas-kit-docs.pages.dev/ai/ for the full machine-readable surface.

## Interfaces

<a id="capacitysummary"></a>

### CapacitySummary

Defined in: [packages/sage/src/internal/fleet.ts:23](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L23)

Used/total Fleet capacity in the units of its on-chain capacity axis.

#### Example

```ts
declare const capacity: CapacitySummary;
const remaining = capacity.remaining;
```

#### Properties

<a id="overcapacity"></a>

##### overCapacity

```ts
readonly overCapacity: bigint;
```

Defined in: [packages/sage/src/internal/fleet.ts:27](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L27)

<a id="remaining"></a>

##### remaining

```ts
readonly remaining: bigint;
```

Defined in: [packages/sage/src/internal/fleet.ts:26](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L26)

<a id="total"></a>

##### total

```ts
readonly total: bigint;
```

Defined in: [packages/sage/src/internal/fleet.ts:25](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L25)

<a id="used"></a>

##### used

```ts
readonly used: bigint;
```

Defined in: [packages/sage/src/internal/fleet.ts:24](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L24)

***

<a id="fleetaccountdata"></a>

### FleetAccountData

Defined in: [packages/sage/src/internal/c4/fleet.ts:329](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L329)

SDK-owned decoded Fleet data before registry definition resolution.

#### Example

```ts
declare const fleet: FleetAccountData;
const owner = fleet.ownerProfile;
```

#### Properties

<a id="activestimulants"></a>

##### activeStimulants

```ts
readonly activeStimulants: readonly {
  chargesRemaining: number;
  deltaBps: number;
  stat: number;
}[];
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:364](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L364)

<a id="ammobank"></a>

##### ammoBank

```ts
readonly ammoBank: FleetCargoAmountData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:344](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L344)

<a id="ap"></a>

##### ap

```ts
readonly ap: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:348](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L348)

<a id="apreloadexpiresat"></a>

##### apReloadExpiresAt

```ts
readonly apReloadExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:353](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L353)

<a id="bump"></a>

##### bump

```ts
readonly bump: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:331](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L331)

<a id="cargohold"></a>

##### cargoHold

```ts
readonly cargoHold: FleetCargoPodData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:363](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L363)

<a id="components"></a>

##### components

```ts
readonly components: FleetCargoPodData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:362](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L362)

<a id="crewcount"></a>

##### crewCount

```ts
readonly crewCount: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:345](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L345)

<a id="faction"></a>

##### faction

```ts
readonly faction: "unaligned" | "mud" | "oni" | "ustur";
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:336](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L336)

<a id="fleetships"></a>

##### fleetShips

```ts
readonly fleetShips: readonly FleetShipAmountData[];
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:360](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L360)

<a id="fueltank"></a>

##### fuelTank

```ts
readonly fuelTank: FleetCargoAmountData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:343](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L343)

<a id="game"></a>

##### game

```ts
readonly game: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:332](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L332)

<a id="hp"></a>

##### hp

```ts
readonly hp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:350](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L350)

<a id="lastcombatupdate"></a>

##### lastCombatUpdate

```ts
readonly lastCombatUpdate: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:355](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L355)

<a id="lastupdateat"></a>

##### lastUpdateAt

```ts
readonly lastUpdateAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:359](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L359)

<a id="location"></a>

##### location

```ts
readonly location: WorldCoordinates;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:356](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L356)

<a id="locationraw"></a>

##### locationRaw

```ts
readonly locationRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:358](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L358)

Exact stored I8F56 coordinates; use these for arithmetic, not the display numbers.

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

<a id="name"></a>

##### name

```ts
readonly name: string;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:338](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L338)

<a id="npcfactionid"></a>

##### npcFactionId

```ts
readonly npcFactionId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:337](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L337)

<a id="ownerprofile"></a>

##### ownerProfile

```ts
readonly ownerProfile: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:333](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L333)

<a id="pendinghp"></a>

##### pendingHp

```ts
readonly pendingHp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:351](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L351)

<a id="rentedcrew"></a>

##### rentedCrew

```ts
readonly rentedCrew: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:346](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L346)

<a id="respawningcargo"></a>

##### respawningCargo

```ts
readonly respawningCargo: FleetCargoPodData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:361](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L361)

<a id="scancooldownexpiresat"></a>

##### scanCooldownExpiresAt

```ts
readonly scanCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:341](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L341)

<a id="shieldbreakdelayexpiresat"></a>

##### shieldBreakDelayExpiresAt

```ts
readonly shieldBreakDelayExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:354](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L354)

<a id="shipcounts"></a>

##### shipCounts

```ts
readonly shipCounts: FleetShipCountsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:339](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L339)

<a id="shipdefinitionsseqid"></a>

##### shipDefinitionsSeqId

```ts
readonly shipDefinitionsSeqId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:347](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L347)

<a id="sp"></a>

##### sp

```ts
readonly sp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:349](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L349)

<a id="stance"></a>

##### stance

```ts
readonly stance: {
  ammoUsage: "none" | "light" | "heavy";
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:352](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L352)

###### ammoUsage

```ts
readonly ammoUsage: "none" | "light" | "heavy";
```

<a id="state"></a>

##### state

```ts
readonly state: FleetStateData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:369](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L369)

<a id="stats"></a>

##### stats

```ts
readonly stats: FleetStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:342](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L342)

<a id="subprofile"></a>

##### subProfile

```ts
readonly subProfile: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:334](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L334)

<a id="subprofileinvalidator"></a>

##### subProfileInvalidator

```ts
readonly subProfileInvalidator: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:335](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L335)

<a id="version"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:330](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L330)

<a id="warpcooldownexpiresat"></a>

##### warpCooldownExpiresAt

```ts
readonly warpCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:340](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L340)

***

<a id="fleetcargoamountdata"></a>

### FleetCargoAmountData

Defined in: [packages/sage/src/internal/c4/fleet.ts:68](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L68)

One unresolved cargo amount decoded from Fleet account data.

#### Example

```ts
declare const cargo: FleetCargoAmountData;
const cargoId = cargo.cargoId;
```

#### Properties

<a id="amount"></a>

##### amount

```ts
readonly amount: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:70](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L70)

<a id="cargoid"></a>

##### cargoId

```ts
readonly cargoId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:69](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L69)

***

<a id="fleetcargopoddata"></a>

### FleetCargoPodData

Defined in: [packages/sage/src/internal/c4/fleet.ts:80](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L80)

One immutable cargo pod decoded from Fleet account data.

#### Example

```ts
declare const pod: FleetCargoPodData;
const amounts = pod.amounts;
```

#### Properties

<a id="amounts"></a>

##### amounts

```ts
readonly amounts: readonly FleetCargoAmountData[];
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:83](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L83)

<a id="seqid"></a>

##### seqId

```ts
readonly seqId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:81](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L81)

<a id="storagecost"></a>

##### storageCost

```ts
readonly storageCost: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:82](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L82)

***

<a id="fleetcargostatsdata"></a>

### FleetCargoStatsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:200](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L200)

Translated Fleet cargo statistics.

#### Example

```ts
declare const stats: FleetCargoStatsData;
const capacity = stats.cargoCapacity;
```

#### Properties

<a id="ammocapacity"></a>

##### ammoCapacity

```ts
readonly ammoCapacity: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:203](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L203)

<a id="ammoconsumptionrate"></a>

##### ammoConsumptionRate

```ts
readonly ammoConsumptionRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:204](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L204)

<a id="cargocapacity"></a>

##### cargoCapacity

```ts
readonly cargoCapacity: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:201](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L201)

<a id="foodconsumptionrate"></a>

##### foodConsumptionRate

```ts
readonly foodConsumptionRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:205](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L205)

<a id="fuelcapacity"></a>

##### fuelCapacity

```ts
readonly fuelCapacity: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:202](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L202)

<a id="loadrate"></a>

##### loadRate

```ts
readonly loadRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:207](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L207)

<a id="miningrate"></a>

##### miningRate

```ts
readonly miningRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:206](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L206)

***

<a id="fleetcoordinatewarpestimate"></a>

### FleetCoordinateWarpEstimate

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:36](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L36)

Whole-second duration including spool and whole-unit Fuel debit estimate.
withinRange compares only computed distance with the stored maximum; it is
not permission to travel. Raw distance has 56 fractional bits; AU is approximate.

#### Example

```ts
declare const estimate: FleetCoordinateWarpEstimate;
console.log(estimate.durationSeconds, estimate.fuelDebit, estimate.withinRange);
```

#### Properties

<a id="distanceau"></a>

##### distanceAu

```ts
readonly distanceAu: number;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:37](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L37)

<a id="distanceraw"></a>

##### distanceRaw

```ts
readonly distanceRaw: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:38](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L38)

<a id="durationseconds"></a>

##### durationSeconds

```ts
readonly durationSeconds: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:39](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L39)

<a id="fueldebit"></a>

##### fuelDebit

```ts
readonly fuelDebit: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:40](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L40)

<a id="withinrange"></a>

##### withinRange

```ts
readonly withinRange: boolean;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:41](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L41)

#### Methods

<a id="tojson"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:42](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L42)

###### Returns

`unknown`

***

<a id="fleetcoordinatewarpestimateinput"></a>

### FleetCoordinateWarpEstimateInput

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:17](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L17)

Exact inputs for an Idle Fleet's coordinate warp, not lane travel.
Coordinates are I8F56, speed U16F16, Fuel rate U26F6, Character warp-speed
modifier I32F32, range U8F8 and spool time integer seconds.

#### Example

```ts
const input: FleetCoordinateWarpEstimateInput = {
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
  spoolSeconds: 3, maxWarpDistanceRaw: 256n,
};
```

#### Properties

<a id="fromraw"></a>

##### fromRaw

```ts
readonly fromRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:18](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L18)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

<a id="fuelrateraw"></a>

##### fuelRateRaw

```ts
readonly fuelRateRaw: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:21](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L21)

<a id="maxwarpdistanceraw"></a>

##### maxWarpDistanceRaw

```ts
readonly maxWarpDistanceRaw: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:24](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L24)

<a id="speedmodifierraw"></a>

##### speedModifierRaw

```ts
readonly speedModifierRaw: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:22](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L22)

<a id="speedraw"></a>

##### speedRaw

```ts
readonly speedRaw: bigint;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:20](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L20)

<a id="spoolseconds"></a>

##### spoolSeconds

```ts
readonly spoolSeconds: number;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:23](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L23)

<a id="toraw"></a>

##### toRaw

```ts
readonly toRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:19](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L19)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

***

<a id="fleetfixedvalue"></a>

### FleetFixedValue

Defined in: [packages/sage/src/internal/c4/fleet.ts:56](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L56)

A translated fixed-point value retaining exact arithmetic source data.

#### Example

```ts
declare const fixed: FleetFixedValue;
const exact = fixed.raw;
```

#### Properties

<a id="raw"></a>

##### raw

```ts
readonly raw: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:57](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L57)

<a id="value"></a>

##### value

```ts
readonly value: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:58](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L58)

***

<a id="fleetmiscstatsdata"></a>

### FleetMiscStatsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:289](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L289)

Translated miscellaneous Fleet statistics.

#### Example

```ts
declare const stats: FleetMiscStatsData;
const requiredCrew = stats.requiredCrew;
```

#### Properties

<a id="lpvalue"></a>

##### lpValue

```ts
readonly lpValue: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:302](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L302)

<a id="medallionvalue"></a>

##### medallionValue

```ts
readonly medallionValue: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:303](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L303)

<a id="passengercapacity"></a>

##### passengerCapacity

```ts
readonly passengerCapacity: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:291](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L291)

<a id="requiredcrew"></a>

##### requiredCrew

```ts
readonly requiredCrew: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:290](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L290)

<a id="respawnfeeatlas"></a>

##### respawnFeeAtlas

```ts
readonly respawnFeeAtlas: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:295](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L295)

<a id="respawnfeeraw"></a>

##### respawnFeeRaw

```ts
readonly respawnFeeRaw: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:294](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L294)

<a id="respawntimewithfeeseconds"></a>

##### respawnTimeWithFeeSeconds

```ts
readonly respawnTimeWithFeeSeconds: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:293](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L293)

<a id="respawntimewithoutfeeseconds"></a>

##### respawnTimeWithoutFeeSeconds

```ts
readonly respawnTimeWithoutFeeSeconds: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:292](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L292)

<a id="scanbonus"></a>

##### scanBonus

```ts
readonly scanBonus: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:301](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L301)

<a id="scancooldownseconds"></a>

##### scanCoolDownSeconds

```ts
readonly scanCoolDownSeconds: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:297](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L297)

U16F16 fixed-point scanning cooldown in seconds.

<a id="scancost"></a>

##### scanCost

```ts
readonly scanCost: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:300](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L300)

<a id="scanpower"></a>

##### scanPower

```ts
readonly scanPower: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:299](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L299)

U26F6 fixed-point scanning power.

<a id="xpvalue"></a>

##### xpValue

```ts
readonly xpValue: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:305](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L305)

U16F16 fixed-point configured XP value; not an awarded-XP calculation.

***

<a id="fleetmovementstatsdata"></a>

### FleetMovementStatsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:180](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L180)

Translated Fleet movement statistics.

#### Example

```ts
declare const stats: FleetMovementStatsData;
const speed = stats.subwarpSpeed.value;
```

#### Properties

<a id="maxwarpdistance"></a>

##### maxWarpDistance

```ts
readonly maxWarpDistance: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:184](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L184)

<a id="planetexitfuelamount"></a>

##### planetExitFuelAmount

```ts
readonly planetExitFuelAmount: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:188](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L188)

<a id="subwarpfuelconsumptionrate"></a>

##### subwarpFuelConsumptionRate

```ts
readonly subwarpFuelConsumptionRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:186](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L186)

<a id="subwarpspeed"></a>

##### subwarpSpeed

```ts
readonly subwarpSpeed: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:181](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L181)

<a id="subwarpxprate"></a>

##### subwarpXpRate

```ts
readonly subwarpXpRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:190](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L190)

<a id="warpcooldownseconds"></a>

##### warpCoolDownSeconds

```ts
readonly warpCoolDownSeconds: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:185](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L185)

<a id="warpfuelconsumptionrate"></a>

##### warpFuelConsumptionRate

```ts
readonly warpFuelConsumptionRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:187](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L187)

<a id="warplanespeed"></a>

##### warpLaneSpeed

```ts
readonly warpLaneSpeed: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:183](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L183)

<a id="warpspeed"></a>

##### warpSpeed

```ts
readonly warpSpeed: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:182](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L182)

<a id="warpxprate"></a>

##### warpXpRate

```ts
readonly warpXpRate: FleetFixedValue;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:189](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L189)

***

<a id="fleetshipamountdata"></a>

### FleetShipAmountData

Defined in: [packages/sage/src/internal/c4/fleet.ts:93](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L93)

One unresolved ship quantity decoded from Fleet account data.

#### Example

```ts
declare const ship: FleetShipAmountData;
const quantity = ship.quantity;
```

#### Properties

<a id="quantity"></a>

##### quantity

```ts
readonly quantity: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:95](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L95)

<a id="shipid"></a>

##### shipId

```ts
readonly shipId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:94](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L94)

***

<a id="fleetshipcountsdata"></a>

### FleetShipCountsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:105](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L105)

Fleet ship counts by SAGE size class.

#### Example

```ts
declare const counts: FleetShipCountsData;
const total = counts.total;
```

#### Properties

<a id="capital"></a>

##### capital

```ts
readonly capital: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:112](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L112)

<a id="commander"></a>

##### commander

```ts
readonly commander: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:113](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L113)

<a id="large"></a>

##### large

```ts
readonly large: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:111](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L111)

<a id="medium"></a>

##### medium

```ts
readonly medium: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:110](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L110)

<a id="small"></a>

##### small

```ts
readonly small: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:109](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L109)

<a id="titan"></a>

##### titan

```ts
readonly titan: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:114](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L114)

<a id="total-1"></a>

##### total

```ts
readonly total: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:106](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L106)

<a id="xsmall"></a>

##### xSmall

```ts
readonly xSmall: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:108](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L108)

<a id="xxsmall"></a>

##### xxSmall

```ts
readonly xxSmall: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:107](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L107)

***

<a id="fleetsnapshot"></a>

### FleetSnapshot

Defined in: [packages/sage/src/fleets/index.ts:127](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L127)

Immutable, translated Fleet snapshot with registry-resolved definitions.

#### Example

```ts
declare const ctx: SageContext;
declare const fleetAddress: Address;
const fleet: FleetSnapshot = await getFleet(ctx, fleetAddress);
console.log(fleet.name, fleet.ships);
```

#### Extends

- `Omit`\<[`ResolvedFleetAccountData`](/reference/fleets/#resolvedfleetaccountdata), `"ownerProfile"`\>

#### Extended by

- [`FleetView`](/reference/#fleetview)

#### Properties

<a id="activestimulants-1"></a>

##### activeStimulants

```ts
readonly activeStimulants: readonly {
  chargesRemaining: number;
  deltaBps: number;
  stat: number;
}[];
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:364](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L364)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`activeStimulants`](/reference/fleets/#fleetaccountdata)

<a id="address"></a>

##### address

```ts
readonly address: Address;
```

Defined in: [packages/sage/src/fleets/index.ts:132](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L132)

<a id="ammo"></a>

##### ammo

```ts
readonly ammo: ResolvedCargoAmount;
```

Defined in: [packages/sage/src/internal/fleet.ts:103](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L103)

###### Inherited from

[`ResolvedFleetAccountData`](/reference/fleets/#resolvedfleetaccountdata).[`ammo`](/reference/fleets/#resolvedfleetaccountdata)

<a id="ap-1"></a>

##### ap

```ts
readonly ap: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:348](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L348)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`ap`](/reference/fleets/#fleetaccountdata)

<a id="apreloadexpiresat-1"></a>

##### apReloadExpiresAt

```ts
readonly apReloadExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:353](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L353)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`apReloadExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="bump-1"></a>

##### bump

```ts
readonly bump: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:331](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L331)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`bump`](/reference/fleets/#fleetaccountdata)

<a id="capacities"></a>

##### capacities

```ts
readonly capacities: {
  ammo: CapacitySummary;
  cargo: CapacitySummary;
  fuel: CapacitySummary;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:119](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L119)

###### ammo

```ts
readonly ammo: CapacitySummary;
```

###### cargo

```ts
readonly cargo: CapacitySummary;
```

###### fuel

```ts
readonly fuel: CapacitySummary;
```

###### Inherited from

```ts
Omit.capacities
```

<a id="cargohold-1"></a>

##### cargoHold

```ts
readonly cargoHold: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:104](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L104)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

###### Inherited from

```ts
Omit.cargoHold
```

<a id="components-1"></a>

##### components

```ts
readonly components: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:109](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L109)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

###### Inherited from

```ts
Omit.components
```

<a id="crewcount-1"></a>

##### crewCount

```ts
readonly crewCount: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:345](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L345)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`crewCount`](/reference/fleets/#fleetaccountdata)

<a id="faction-1"></a>

##### faction

```ts
readonly faction: "unaligned" | "mud" | "oni" | "ustur";
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:336](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L336)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`faction`](/reference/fleets/#fleetaccountdata)

<a id="fuel"></a>

##### fuel

```ts
readonly fuel: ResolvedCargoAmount;
```

Defined in: [packages/sage/src/internal/fleet.ts:102](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L102)

###### Inherited from

[`ResolvedFleetAccountData`](/reference/fleets/#resolvedfleetaccountdata).[`fuel`](/reference/fleets/#resolvedfleetaccountdata)

<a id="game-1"></a>

##### game

```ts
readonly game: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:332](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L332)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`game`](/reference/fleets/#fleetaccountdata)

<a id="hp-1"></a>

##### hp

```ts
readonly hp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:350](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L350)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`hp`](/reference/fleets/#fleetaccountdata)

<a id="kind"></a>

##### kind

```ts
readonly kind: "fleet";
```

Defined in: [packages/sage/src/fleets/index.ts:131](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L131)

<a id="lastcombatupdate-1"></a>

##### lastCombatUpdate

```ts
readonly lastCombatUpdate: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:355](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L355)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`lastCombatUpdate`](/reference/fleets/#fleetaccountdata)

<a id="lastupdateat-1"></a>

##### lastUpdateAt

```ts
readonly lastUpdateAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:359](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L359)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`lastUpdateAt`](/reference/fleets/#fleetaccountdata)

<a id="location-1"></a>

##### location

```ts
readonly location: WorldCoordinates;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:356](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L356)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`location`](/reference/fleets/#fleetaccountdata)

<a id="locationraw-1"></a>

##### locationRaw

```ts
readonly locationRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:358](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L358)

Exact stored I8F56 coordinates; use these for arithmetic, not the display numbers.

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`locationRaw`](/reference/fleets/#fleetaccountdata)

<a id="name-1"></a>

##### name

```ts
readonly name: string;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:338](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L338)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`name`](/reference/fleets/#fleetaccountdata)

<a id="npcfactionid-1"></a>

##### npcFactionId

```ts
readonly npcFactionId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:337](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L337)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`npcFactionId`](/reference/fleets/#fleetaccountdata)

<a id="ownerprofile-1"></a>

##### ownerProfile

```ts
readonly ownerProfile: EntityRef<"profile">;
```

Defined in: [packages/sage/src/fleets/index.ts:133](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L133)

<a id="pendinghp-1"></a>

##### pendingHp

```ts
readonly pendingHp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:351](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L351)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`pendingHp`](/reference/fleets/#fleetaccountdata)

<a id="rentedcrew-1"></a>

##### rentedCrew

```ts
readonly rentedCrew: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:346](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L346)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`rentedCrew`](/reference/fleets/#fleetaccountdata)

<a id="respawningcargo-1"></a>

##### respawningCargo

```ts
readonly respawningCargo: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:114](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L114)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

###### Inherited from

```ts
Omit.respawningCargo
```

<a id="scancooldownexpiresat-1"></a>

##### scanCooldownExpiresAt

```ts
readonly scanCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:341](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L341)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`scanCooldownExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="shieldbreakdelayexpiresat-1"></a>

##### shieldBreakDelayExpiresAt

```ts
readonly shieldBreakDelayExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:354](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L354)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shieldBreakDelayExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="shipcounts-1"></a>

##### shipCounts

```ts
readonly shipCounts: FleetShipCountsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:339](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L339)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shipCounts`](/reference/fleets/#fleetaccountdata)

<a id="shipdefinitionsseqid-1"></a>

##### shipDefinitionsSeqId

```ts
readonly shipDefinitionsSeqId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:347](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L347)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shipDefinitionsSeqId`](/reference/fleets/#fleetaccountdata)

<a id="ships"></a>

##### ships

```ts
readonly ships: readonly ResolvedShipAmount[];
```

Defined in: [packages/sage/src/internal/fleet.ts:101](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L101)

###### Inherited from

```ts
Omit.ships
```

<a id="sp-1"></a>

##### sp

```ts
readonly sp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:349](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L349)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`sp`](/reference/fleets/#fleetaccountdata)

<a id="stance-1"></a>

##### stance

```ts
readonly stance: {
  ammoUsage: "none" | "light" | "heavy";
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:352](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L352)

###### ammoUsage

```ts
readonly ammoUsage: "none" | "light" | "heavy";
```

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`stance`](/reference/fleets/#fleetaccountdata)

<a id="state-1"></a>

##### state

```ts
readonly state: ResolvedFleetState;
```

Defined in: [packages/sage/src/internal/fleet.ts:124](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L124)

###### Inherited from

[`ResolvedFleetAccountData`](/reference/fleets/#resolvedfleetaccountdata).[`state`](/reference/fleets/#resolvedfleetaccountdata)

<a id="stats-1"></a>

##### stats

```ts
readonly stats: FleetStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:342](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L342)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`stats`](/reference/fleets/#fleetaccountdata)

<a id="subprofile-1"></a>

##### subProfile?

```ts
readonly optional subProfile?: Address;
```

Defined in: [packages/sage/src/internal/fleet.ts:98](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L98)

###### Inherited from

```ts
Omit.subProfile
```

<a id="subprofileinvalidator-1"></a>

##### subProfileInvalidator?

```ts
readonly optional subProfileInvalidator?: Address;
```

Defined in: [packages/sage/src/internal/fleet.ts:100](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L100)

The absent encoding is not yet qualified; presence alone does not establish rental authority.

###### Inherited from

```ts
Omit.subProfileInvalidator
```

<a id="version-1"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:330](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L330)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`version`](/reference/fleets/#fleetaccountdata)

<a id="warpcooldownexpiresat-1"></a>

##### warpCooldownExpiresAt

```ts
readonly warpCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:340](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L340)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`warpCooldownExpiresAt`](/reference/fleets/#fleetaccountdata)

#### Methods

<a id="tojson-1"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/index.ts:134](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L134)

###### Returns

`unknown`

***

<a id="fleetstatsdata"></a>

### FleetStatsData

Defined in: [packages/sage/src/internal/c4/fleet.ts:315](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L315)

Grouped translated Fleet statistics.

#### Example

```ts
declare const stats: FleetStatsData;
const movement = stats.movement;
```

#### Properties

<a id="cargo"></a>

##### cargo

```ts
readonly cargo: FleetCargoStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:317](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L317)

<a id="combat"></a>

##### combat

```ts
readonly combat: FleetCombatStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:318](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L318)

<a id="misc"></a>

##### misc

```ts
readonly misc: FleetMiscStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:319](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L319)

<a id="movement"></a>

##### movement

```ts
readonly movement: FleetMovementStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:316](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L316)

***

<a id="fleetsubscriptionobserver"></a>

### FleetSubscriptionObserver

Defined in: [packages/sage/src/fleets/index.ts:148](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L148)

Observer for live, fully translated Fleet snapshots.

#### Example

```ts
const observer: FleetSubscriptionObserver = {
  onSnapshot: fleet => console.log(fleet.name),
  onError: error => console.error(error.code),
  onDiagnostic: event => console.debug(event.kind, event.coalescedCount),
};
```

#### Properties

<a id="ondiagnostic"></a>

##### onDiagnostic?

```ts
readonly optional onDiagnostic?: (event) => void;
```

Defined in: [packages/sage/src/fleets/index.ts:151](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L151)

###### Parameters

| Parameter | Type |
| ------ | ------ |
| `event` | [`SubscriptionDiagnosticEvent`](/reference/#subscriptiondiagnosticevent) |

###### Returns

`void`

<a id="onerror"></a>

##### onError

```ts
readonly onError: (error) => void | Promise<void>;
```

Defined in: [packages/sage/src/fleets/index.ts:150](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L150)

###### Parameters

| Parameter | Type |
| ------ | ------ |
| `error` | [`SageSdkError`](/reference/client/#sagesdkerror) |

###### Returns

`void` \| `Promise`\<`void`\>

<a id="onsnapshot"></a>

##### onSnapshot

```ts
readonly onSnapshot: (fleet) => void | Promise<void>;
```

Defined in: [packages/sage/src/fleets/index.ts:149](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L149)

###### Parameters

| Parameter | Type |
| ------ | ------ |
| `fleet` | [`FleetSnapshot`](/reference/fleets/#fleetsnapshot) |

###### Returns

`void` \| `Promise`\<`void`\>

***

<a id="fleetsubwarpestimate"></a>

### FleetSubwarpEstimate

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:37](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L37)

Prospective journey values; all three raw outputs have 56 fractional bits.
Display numbers are approximate. fuelBudget rounds recorded expenditure up
to whole Fuel units; it is not a measured settlement debit or travel approval.

#### Example

```ts
declare const estimate: FleetSubwarpEstimate;
const budget: bigint = estimate.fuelBudget;
console.log(estimate.durationSeconds, JSON.stringify(estimate));
```

#### Properties

<a id="distanceau-1"></a>

##### distanceAu

```ts
readonly distanceAu: number;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:38](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L38)

<a id="distanceraw-1"></a>

##### distanceRaw

```ts
readonly distanceRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:39](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L39)

<a id="durationseconds-1"></a>

##### durationSeconds

```ts
readonly durationSeconds: number;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:40](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L40)

<a id="durationsecondsraw"></a>

##### durationSecondsRaw

```ts
readonly durationSecondsRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:41](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L41)

<a id="fuelbudget"></a>

##### fuelBudget

```ts
readonly fuelBudget: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:44](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L44)

<a id="fuelexpenditure"></a>

##### fuelExpenditure

```ts
readonly fuelExpenditure: number;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:42](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L42)

<a id="fuelexpenditureraw"></a>

##### fuelExpenditureRaw

```ts
readonly fuelExpenditureRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:43](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L43)

#### Methods

<a id="tojson-2"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:45](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L45)

###### Returns

`unknown`

***

<a id="fleetsubwarpestimateinput"></a>

### FleetSubwarpEstimateInput

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:19](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L19)

Raw inputs for an Idle Fleet's direct subwarp journey.
Coordinates use signed I8F56, speed U16F16, Fuel rate U26F6 and the Character
subwarp-speed modifier I32F32. Use the Fleet's exact stored locationRaw;
reconstructing it from location display numbers loses precision.

#### Example

```ts
const input: FleetSubwarpEstimateInput = {
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
};
```

#### Properties

<a id="fromraw-1"></a>

##### fromRaw

```ts
readonly fromRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:20](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L20)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

<a id="fuelrateraw-1"></a>

##### fuelRateRaw

```ts
readonly fuelRateRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:23](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L23)

<a id="speedmodifierraw-1"></a>

##### speedModifierRaw

```ts
readonly speedModifierRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:24](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L24)

<a id="speedraw-1"></a>

##### speedRaw

```ts
readonly speedRaw: bigint;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:22](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L22)

<a id="toraw-1"></a>

##### toRaw

```ts
readonly toRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:21](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L21)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

***

<a id="fleettimers"></a>

### FleetTimers

Defined in: [packages/sage/src/internal/fleet.ts:291](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L291)

Date-valued timers derived from Fleet account sentinels and lifecycle state.

Fleet snapshots retain their exact bigint unix-second fields; these values
are an ergonomic projection for UI scheduling and display.

#### Example

```ts
declare const timers: FleetTimers;
console.log(
  timers.arrivesAt?.toISOString(),
  timers.transferEndsAt?.toISOString(),
);
```

#### Properties

<a id="abilitypowerreloadsat"></a>

##### abilityPowerReloadsAt?

```ts
readonly optional abilityPowerReloadsAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:294](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L294)

<a id="arrivesat"></a>

##### arrivesAt?

```ts
readonly optional arrivesAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:296](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L296)

<a id="recoversat"></a>

##### recoversAt?

```ts
readonly optional recoversAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:297](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L297)

<a id="scancooldownendsat"></a>

##### scanCooldownEndsAt?

```ts
readonly optional scanCooldownEndsAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:293](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L293)

<a id="shieldregenerationresumesat"></a>

##### shieldRegenerationResumesAt?

```ts
readonly optional shieldRegenerationResumesAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:295](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L295)

<a id="transferendsat"></a>

##### transferEndsAt?

```ts
readonly optional transferEndsAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:298](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L298)

<a id="warpcooldownendsat"></a>

##### warpCooldownEndsAt?

```ts
readonly optional warpCooldownEndsAt?: Date;
```

Defined in: [packages/sage/src/internal/fleet.ts:292](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L292)

***

<a id="fleettravelprofile"></a>

### FleetTravelProfile

Defined in: [packages/sage/src/fleets/travel-profile.ts:52](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L52)

Reference travel values per AU, per maximum-range warp and per full tank.
Each section is null when its speed (or warp range) is zero. Whole seconds
and whole Fuel are bigint, as in the movement estimates; ratios are numbers.
A null full-tank value means that movement mode burns no Fuel.

#### Example

```ts
declare const profile: FleetTravelProfile;
console.log(profile.subwarp?.fullTankRangeAu, JSON.stringify(profile));
```

#### Properties

<a id="coordinatewarp"></a>

##### coordinateWarp

```ts
readonly coordinateWarp: 
  | {
  cooldownSeconds: bigint;
  cycleSeconds: bigint;
  fullTankRangeAu: number | null;
  maxJumpAu: number;
  maxJumpFuel: bigint;
  maxJumpSeconds: bigint;
  maxJumpsPerFullTank: bigint | null;
  sustainedAuPerHour: number;
}
  | null;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:63](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L63)

###### Union Members

###### Type Literal

```ts
{
  cooldownSeconds: bigint;
  cycleSeconds: bigint;
  fullTankRangeAu: number | null;
  maxJumpAu: number;
  maxJumpFuel: bigint;
  maxJumpSeconds: bigint;
  maxJumpsPerFullTank: bigint | null;
  sustainedAuPerHour: number;
}
```

###### cooldownSeconds

```ts
readonly cooldownSeconds: bigint;
```

Whole seconds of warp cooldown assigned at arrival.

###### cycleSeconds

```ts
readonly cycleSeconds: bigint;
```

Seconds from one maximum-range departure to the next: jump plus cooldown.

###### fullTankRangeAu

```ts
readonly fullTankRangeAu: number | null;
```

Distance covered by those warps.

###### maxJumpAu

```ts
readonly maxJumpAu: number;
```

Maximum coordinate-warp distance, in AU.

###### maxJumpFuel

```ts
readonly maxJumpFuel: bigint;
```

Whole Fuel debited for one maximum-range warp.

###### maxJumpSeconds

```ts
readonly maxJumpSeconds: bigint;
```

Whole seconds for one maximum-range warp, including spool.

###### maxJumpsPerFullTank

```ts
readonly maxJumpsPerFullTank: bigint | null;
```

Maximum-range warp debits that fit in a full tank.

###### sustainedAuPerHour

```ts
readonly sustainedAuPerHour: number;
```

AU per hour when chaining maximum-range warps as cooldown allows.

***

`null`

<a id="subwarp"></a>

##### subwarp

```ts
readonly subwarp: 
  | {
  fuelPerAu: number;
  fullTankRangeAu: number | null;
  fullTankSeconds: number | null;
  secondsPerAu: number;
}
  | null;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:53](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L53)

###### Union Members

###### Type Literal

```ts
{
  fuelPerAu: number;
  fullTankRangeAu: number | null;
  fullTankSeconds: number | null;
  secondsPerAu: number;
}
```

###### fuelPerAu

```ts
readonly fuelPerAu: number;
```

Fractional Fuel expenditure recorded for one AU.

###### fullTankRangeAu

```ts
readonly fullTankRangeAu: number | null;
```

Subwarp distance whose Fuel expenditure equals a full tank.

###### fullTankSeconds

```ts
readonly fullTankSeconds: number | null;
```

Seconds to subwarp the full-tank range.

###### secondsPerAu

```ts
readonly secondsPerAu: number;
```

Seconds to subwarp exactly one AU.

***

`null`

<a id="warplane"></a>

##### warpLane

```ts
readonly warpLane: 
  | {
  secondsPerAu: number;
}
  | null;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:81](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L81)

###### Union Members

###### Type Literal

```ts
{
  secondsPerAu: number;
}
```

###### secondsPerAu

```ts
readonly secondsPerAu: number;
```

Seconds per AU of lane; each hop rounds up to whole seconds.

***

`null`

#### Methods

<a id="tojson-3"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:85](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L85)

###### Returns

`unknown`

***

<a id="fleettravelprofileinput"></a>

### FleetTravelProfileInput

Defined in: [packages/sage/src/fleets/travel-profile.ts:22](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L22)

Stats read by the travel profile: a Fleet's `stats` or a ship configuration's
`stats`, which equal a one-ship Fleet's. Character modifiers are raw I32F32
values; omitted or zero modifiers are neutral, as in the movement estimates.

#### Example

```ts
declare const ship: { readonly stats: FleetTravelProfileInput['stats'] };
const input: FleetTravelProfileInput = { stats: ship.stats };
```

#### Properties

<a id="stats-2"></a>

##### stats

```ts
readonly stats: {
  cargo: Pick<FleetCargoStatsData, "fuelCapacity">;
  combat: Pick<FleetCombatStatsData, "warpSpoolTimeSeconds">;
  movement: Pick<FleetMovementStatsData, 
     | "subwarpSpeed"
     | "subwarpFuelConsumptionRate"
     | "warpSpeed"
     | "warpFuelConsumptionRate"
     | "maxWarpDistance"
     | "warpCoolDownSeconds"
    | "warpLaneSpeed">;
};
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:23](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L23)

###### cargo

```ts
readonly cargo: Pick<FleetCargoStatsData, "fuelCapacity">;
```

###### combat

```ts
readonly combat: Pick<FleetCombatStatsData, "warpSpoolTimeSeconds">;
```

###### movement

```ts
readonly movement: Pick<FleetMovementStatsData, 
  | "subwarpSpeed"
  | "subwarpFuelConsumptionRate"
  | "warpSpeed"
  | "warpFuelConsumptionRate"
  | "maxWarpDistance"
  | "warpCoolDownSeconds"
| "warpLaneSpeed">;
```

<a id="subwarpspeedmodifierraw"></a>

##### subwarpSpeedModifierRaw?

```ts
readonly optional subwarpSpeedModifierRaw?: bigint;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:37](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L37)

<a id="warpcooldownmodifierraw"></a>

##### warpCooldownModifierRaw?

```ts
readonly optional warpCooldownModifierRaw?: bigint;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:39](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L39)

<a id="warpspeedmodifierraw"></a>

##### warpSpeedModifierRaw?

```ts
readonly optional warpSpeedModifierRaw?: bigint;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:38](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L38)

***

<a id="fleetwarplaneestimate"></a>

### FleetWarpLaneEstimate

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:29](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L29)

Whole-second lane duration and zero Fuel debit on the qualified deployment.
Raw distance has 56 fractional bits; AU is approximate.

#### Example

```ts
declare const estimate: FleetWarpLaneEstimate;
console.log(estimate.durationSeconds, estimate.fuelDebit);
```

#### Properties

<a id="distanceau-2"></a>

##### distanceAu

```ts
readonly distanceAu: number;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:30](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L30)

<a id="distanceraw-2"></a>

##### distanceRaw

```ts
readonly distanceRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:31](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L31)

<a id="durationseconds-2"></a>

##### durationSeconds

```ts
readonly durationSeconds: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:32](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L32)

<a id="fueldebit-1"></a>

##### fuelDebit

```ts
readonly fuelDebit: 0n;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:33](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L33)

#### Methods

<a id="tojson-4"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:34](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L34)

###### Returns

`unknown`

***

<a id="fleetwarplaneestimateinput"></a>

### FleetWarpLaneEstimateInput

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:15](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L15)

Exact System coordinates (I8F56) and Fleet lane speed (U16F16).
No Character warp-speed modifier or spool time applies to lane travel.

#### Example

```ts
const input: FleetWarpLaneEstimateInput = {
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n,
};
```

#### Properties

<a id="fromraw-2"></a>

##### fromRaw

```ts
readonly fromRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:16](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L16)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

<a id="speedraw-2"></a>

##### speedRaw

```ts
readonly speedRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:18](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L18)

<a id="toraw-2"></a>

##### toRaw

```ts
readonly toRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:17](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L17)

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

***

<a id="fleetwarplanepolicy"></a>

### FleetWarpLanePolicy

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:52](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L52)

Policy result only: passing never proves travel eligibility or affordability.

#### Example

```ts
declare const assessment: FleetWarpLanePolicy;
console.log(assessment.passesPolicy, assessment.failures);
```

#### Properties

<a id="effectiverisk"></a>

##### effectiveRisk

```ts
readonly effectiveRisk: 
  | {
  faction: FactionAlignment;
  kind: "low";
}
  | {
  kind: "medium" | "high";
};
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:55](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L55)

<a id="failures"></a>

##### failures

```ts
readonly failures: readonly FleetWarpLanePolicyFailure[];
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:54](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L54)

<a id="passespolicy"></a>

##### passesPolicy

```ts
readonly passesPolicy: boolean;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:53](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L53)

#### Methods

<a id="tojson-5"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:56](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L56)

###### Returns

`unknown`

***

<a id="fleetwarplanepolicyinput"></a>

### FleetWarpLanePolicyInput

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:15](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L15)

Explicit lane policy inputs; destinationRegion must contain the destination coordinates.
A System's stored region id alone does not establish this spatial relationship.

#### Example

```ts
declare const input: FleetWarpLanePolicyInput;
console.log(input.destinationRegion.risk, input.securityZoneAccess);
```

#### Properties

<a id="crossfactioneconomicsenabled"></a>

##### crossFactionEconomicsEnabled

```ts
readonly crossFactionEconomicsEnabled: boolean;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:21](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L21)

<a id="destinationlevel"></a>

##### destinationLevel

```ts
readonly destinationLevel: WorldStarbaseLevel;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:20](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L20)

<a id="destinationowner"></a>

##### destinationOwner

```ts
readonly destinationOwner: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:18](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L18)

<a id="destinationregion"></a>

##### destinationRegion

```ts
readonly destinationRegion: Pick<FactionRegionData, "owner" | "safety" | "risk">;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:22](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L22)

<a id="enemyfactionzoneaccess"></a>

##### enemyFactionZoneAccess

```ts
readonly enemyFactionZoneAccess: boolean;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:28](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L28)

The Character's enemy-faction-zone access research.

<a id="fleetfaction"></a>

##### fleetFaction

```ts
readonly fleetFaction: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:16](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L16)

<a id="securityzoneaccess"></a>

##### securityZoneAccess

```ts
readonly securityZoneAccess: RiskZoneAccess;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:26](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L26)

<a id="sourcelevel"></a>

##### sourceLevel

```ts
readonly sourceLevel: WorldStarbaseLevel;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:19](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L19)

<a id="sourceowner"></a>

##### sourceOwner

```ts
readonly sourceOwner: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:17](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L17)

***

<a id="fleetwarplanetoll"></a>

### FleetWarpLaneToll

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:45](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L45)

Character's prospective ATLAS debit, entirely in raw ATLAS units (Floyds).

#### Example

```ts
declare const toll: FleetWarpLaneToll;
console.log(toll.modifiedBaseRaw, toll.surchargeRaw, toll.totalRaw);
```

#### Properties

<a id="baseraw"></a>

##### baseRaw

```ts
readonly baseRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:46](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L46)

<a id="modifiedbaseraw"></a>

##### modifiedBaseRaw

```ts
readonly modifiedBaseRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:47](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L47)

<a id="surchargeraw"></a>

##### surchargeRaw

```ts
readonly surchargeRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:48](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L48)

<a id="totalraw"></a>

##### totalRaw

```ts
readonly totalRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:49](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L49)

#### Methods

<a id="tojson-6"></a>

##### toJSON()

```ts
toJSON(): unknown;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:50](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L50)

###### Returns

`unknown`

***

<a id="fleetwarplanetollinput"></a>

### FleetWarpLaneTollInput

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:18](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L18)

Current source connection costs, ownership and Character fee modifier.
destinationRelationship is Fleet-to-destination-owner, not endpoint-to-endpoint.

#### Example

```ts
declare const input: FleetWarpLaneTollInput;
console.log(input.sourceLevel, input.feeModifierRaw);
```

#### Properties

<a id="alliedtollbps"></a>

##### alliedTollBps

```ts
readonly alliedTollBps: number;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:34](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L34)

<a id="costs"></a>

##### costs

```ts
readonly costs: Pick<WorldConnectionCosts, 
  | "level1Raw"
  | "level2Raw"
  | "level3Raw"
  | "level4Raw"
  | "level5Raw"
| "cssRaw">;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:19](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L19)

<a id="destinationowner-1"></a>

##### destinationOwner

```ts
readonly destinationOwner: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:31](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L31)

<a id="destinationrelationship"></a>

##### destinationRelationship

```ts
readonly destinationRelationship: FactionRelationship;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:32](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L32)

<a id="feemodifierraw"></a>

##### feeModifierRaw

```ts
readonly feeModifierRaw: bigint;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:33](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L33)

<a id="fleetfaction-1"></a>

##### fleetFaction

```ts
readonly fleetFaction: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:29](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L29)

<a id="neutraltollbps"></a>

##### neutralTollBps

```ts
readonly neutralTollBps: number;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:35](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L35)

<a id="sourcelevel-1"></a>

##### sourceLevel

```ts
readonly sourceLevel: WorldStarbaseLevel;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:28](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L28)

<a id="sourceowner-1"></a>

##### sourceOwner

```ts
readonly sourceOwner: WorldFaction;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:30](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L30)

***

<a id="resolvedfleetaccountdata"></a>

### ResolvedFleetAccountData

Defined in: [packages/sage/src/internal/fleet.ts:86](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L86)

Fleet data after joining account ids against the lazy definitions registry.

#### Example

```ts
declare const fleet: ResolvedFleetAccountData;
const shipName = fleet.ships[0]?.name;
```

#### Extends

- `Omit`\<[`FleetAccountData`](/reference/fleets/#fleetaccountdata), 
  \| `"fleetShips"`
  \| `"fuelTank"`
  \| `"ammoBank"`
  \| `"cargoHold"`
  \| `"components"`
  \| `"respawningCargo"`
  \| `"state"`
  \| `"subProfile"`
  \| `"subProfileInvalidator"`\>

#### Properties

<a id="activestimulants-2"></a>

##### activeStimulants

```ts
readonly activeStimulants: readonly {
  chargesRemaining: number;
  deltaBps: number;
  stat: number;
}[];
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:364](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L364)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`activeStimulants`](/reference/fleets/#fleetaccountdata)

<a id="ammo-1"></a>

##### ammo

```ts
readonly ammo: ResolvedCargoAmount;
```

Defined in: [packages/sage/src/internal/fleet.ts:103](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L103)

<a id="ap-2"></a>

##### ap

```ts
readonly ap: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:348](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L348)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`ap`](/reference/fleets/#fleetaccountdata)

<a id="apreloadexpiresat-2"></a>

##### apReloadExpiresAt

```ts
readonly apReloadExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:353](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L353)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`apReloadExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="bump-2"></a>

##### bump

```ts
readonly bump: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:331](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L331)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`bump`](/reference/fleets/#fleetaccountdata)

<a id="capacities-1"></a>

##### capacities

```ts
readonly capacities: {
  ammo: CapacitySummary;
  cargo: CapacitySummary;
  fuel: CapacitySummary;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:119](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L119)

###### ammo

```ts
readonly ammo: CapacitySummary;
```

###### cargo

```ts
readonly cargo: CapacitySummary;
```

###### fuel

```ts
readonly fuel: CapacitySummary;
```

<a id="cargohold-2"></a>

##### cargoHold

```ts
readonly cargoHold: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:104](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L104)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

<a id="components-2"></a>

##### components

```ts
readonly components: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:109](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L109)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

<a id="crewcount-2"></a>

##### crewCount

```ts
readonly crewCount: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:345](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L345)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`crewCount`](/reference/fleets/#fleetaccountdata)

<a id="faction-2"></a>

##### faction

```ts
readonly faction: "unaligned" | "mud" | "oni" | "ustur";
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:336](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L336)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`faction`](/reference/fleets/#fleetaccountdata)

<a id="fuel-1"></a>

##### fuel

```ts
readonly fuel: ResolvedCargoAmount;
```

Defined in: [packages/sage/src/internal/fleet.ts:102](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L102)

<a id="game-2"></a>

##### game

```ts
readonly game: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:332](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L332)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`game`](/reference/fleets/#fleetaccountdata)

<a id="hp-2"></a>

##### hp

```ts
readonly hp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:350](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L350)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`hp`](/reference/fleets/#fleetaccountdata)

<a id="lastcombatupdate-2"></a>

##### lastCombatUpdate

```ts
readonly lastCombatUpdate: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:355](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L355)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`lastCombatUpdate`](/reference/fleets/#fleetaccountdata)

<a id="lastupdateat-2"></a>

##### lastUpdateAt

```ts
readonly lastUpdateAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:359](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L359)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`lastUpdateAt`](/reference/fleets/#fleetaccountdata)

<a id="location-2"></a>

##### location

```ts
readonly location: WorldCoordinates;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:356](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L356)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`location`](/reference/fleets/#fleetaccountdata)

<a id="locationraw-2"></a>

##### locationRaw

```ts
readonly locationRaw: {
  x: bigint;
  y: bigint;
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:358](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L358)

Exact stored I8F56 coordinates; use these for arithmetic, not the display numbers.

###### x

```ts
readonly x: bigint;
```

###### y

```ts
readonly y: bigint;
```

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`locationRaw`](/reference/fleets/#fleetaccountdata)

<a id="name-2"></a>

##### name

```ts
readonly name: string;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:338](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L338)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`name`](/reference/fleets/#fleetaccountdata)

<a id="npcfactionid-2"></a>

##### npcFactionId

```ts
readonly npcFactionId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:337](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L337)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`npcFactionId`](/reference/fleets/#fleetaccountdata)

<a id="ownerprofile-2"></a>

##### ownerProfile

```ts
readonly ownerProfile: Address;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:333](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L333)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`ownerProfile`](/reference/fleets/#fleetaccountdata)

<a id="pendinghp-2"></a>

##### pendingHp

```ts
readonly pendingHp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:351](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L351)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`pendingHp`](/reference/fleets/#fleetaccountdata)

<a id="rentedcrew-2"></a>

##### rentedCrew

```ts
readonly rentedCrew: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:346](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L346)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`rentedCrew`](/reference/fleets/#fleetaccountdata)

<a id="respawningcargo-2"></a>

##### respawningCargo

```ts
readonly respawningCargo: {
  items: readonly ResolvedCargoAmount[];
  seqId: number;
  storageCost: bigint;
};
```

Defined in: [packages/sage/src/internal/fleet.ts:114](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L114)

###### items

```ts
readonly items: readonly ResolvedCargoAmount[];
```

###### seqId

```ts
readonly seqId: number;
```

###### storageCost

```ts
readonly storageCost: bigint;
```

<a id="scancooldownexpiresat-2"></a>

##### scanCooldownExpiresAt

```ts
readonly scanCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:341](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L341)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`scanCooldownExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="shieldbreakdelayexpiresat-2"></a>

##### shieldBreakDelayExpiresAt

```ts
readonly shieldBreakDelayExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:354](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L354)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shieldBreakDelayExpiresAt`](/reference/fleets/#fleetaccountdata)

<a id="shipcounts-2"></a>

##### shipCounts

```ts
readonly shipCounts: FleetShipCountsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:339](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L339)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shipCounts`](/reference/fleets/#fleetaccountdata)

<a id="shipdefinitionsseqid-2"></a>

##### shipDefinitionsSeqId

```ts
readonly shipDefinitionsSeqId: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:347](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L347)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`shipDefinitionsSeqId`](/reference/fleets/#fleetaccountdata)

<a id="ships-1"></a>

##### ships

```ts
readonly ships: readonly ResolvedShipAmount[];
```

Defined in: [packages/sage/src/internal/fleet.ts:101](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L101)

<a id="sp-2"></a>

##### sp

```ts
readonly sp: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:349](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L349)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`sp`](/reference/fleets/#fleetaccountdata)

<a id="stance-2"></a>

##### stance

```ts
readonly stance: {
  ammoUsage: "none" | "light" | "heavy";
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:352](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L352)

###### ammoUsage

```ts
readonly ammoUsage: "none" | "light" | "heavy";
```

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`stance`](/reference/fleets/#fleetaccountdata)

<a id="state-2"></a>

##### state

```ts
readonly state: ResolvedFleetState;
```

Defined in: [packages/sage/src/internal/fleet.ts:124](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L124)

<a id="stats-3"></a>

##### stats

```ts
readonly stats: FleetStatsData;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:342](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L342)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`stats`](/reference/fleets/#fleetaccountdata)

<a id="subprofile-2"></a>

##### subProfile?

```ts
readonly optional subProfile?: Address;
```

Defined in: [packages/sage/src/internal/fleet.ts:98](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L98)

<a id="subprofileinvalidator-2"></a>

##### subProfileInvalidator?

```ts
readonly optional subProfileInvalidator?: Address;
```

Defined in: [packages/sage/src/internal/fleet.ts:100](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L100)

The absent encoding is not yet qualified; presence alone does not establish rental authority.

<a id="version-2"></a>

##### version

```ts
readonly version: number;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:330](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L330)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`version`](/reference/fleets/#fleetaccountdata)

<a id="warpcooldownexpiresat-2"></a>

##### warpCooldownExpiresAt

```ts
readonly warpCooldownExpiresAt: bigint;
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:340](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L340)

###### Inherited from

[`FleetAccountData`](/reference/fleets/#fleetaccountdata).[`warpCooldownExpiresAt`](/reference/fleets/#fleetaccountdata)

***

<a id="subwarpposition"></a>

### SubwarpPosition

Defined in: [packages/sage/src/internal/fleet.ts:384](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L384)

Display-only interpolation matching incremental on-chain subwarp settlement.

#### Example

```ts
declare const subwarp: SubwarpPosition;
if (subwarp.displayOnly) console.log(subwarp.position, subwarp.progress);
```

#### Properties

<a id="displayonly"></a>

##### displayOnly

```ts
readonly displayOnly: true;
```

Defined in: [packages/sage/src/internal/fleet.ts:385](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L385)

<a id="position"></a>

##### position

```ts
readonly position: WorldCoordinates;
```

Defined in: [packages/sage/src/internal/fleet.ts:386](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L386)

<a id="progress"></a>

##### progress

```ts
readonly progress: number;
```

Defined in: [packages/sage/src/internal/fleet.ts:387](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L387)

***

<a id="worldcoordinates"></a>

### WorldCoordinates

Defined in: [packages/sage/src/internal/c4/world.ts:91](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/world.ts#L91)

A position in the shared SAGE coordinate space, in gameplay units.

#### Example

```ts
const coordinates: WorldCoordinates = { x: 1, y: 2 };
```

#### Properties

<a id="x"></a>

##### x

```ts
readonly x: number;
```

Defined in: [packages/sage/src/internal/c4/world.ts:92](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/world.ts#L92)

<a id="y"></a>

##### y

```ts
readonly y: number;
```

Defined in: [packages/sage/src/internal/c4/world.ts:93](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/world.ts#L93)

## Type Aliases

<a id="fleetdiscoveryoptions"></a>

### FleetDiscoveryOptions

```ts
type FleetDiscoveryOptions = Omit<DiscoveryRequest, "filters" | "strategy">;
```

Defined in: [packages/sage/src/fleets/index.ts:112](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L112)

Options supported by targeted Fleet discovery.

#### Example

```ts
declare const ctx: SageContext;
declare const profileAddress: Address;
const options: FleetDiscoveryOptions = {
  commitment: 'confirmed',
  policy: 'no-store',
};
const fleets = await getFleetsByOwner(ctx, profileAddress, options);
```

***

<a id="fleetmovementcooldowninput"></a>

### FleetMovementCooldownInput

```ts
type FleetMovementCooldownInput = 
  | {
  arrivesAtUnixSeconds: bigint;
  baseCooldownSeconds: number;
  cooldownModifierRaw: bigint;
  kind: "coordinateWarp";
}
  | {
  departsAtUnixSeconds: bigint;
  existingCooldownExpiresAt: bigint;
  kind: "warpLane";
}
  | {
  existingCooldownExpiresAt: bigint;
  kind: "subwarp";
};
```

Defined in: [packages/sage/src/fleets/cooldown.ts:13](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/cooldown.ts#L13)

Explicit inputs for cooldown assignment, not permission to move.
The Character modifier is its raw I32F32 value, not its display number.

#### Example

```ts
const input: FleetMovementCooldownInput = {
  kind: 'coordinateWarp', arrivesAtUnixSeconds: 1_800_000_000n,
  baseCooldownSeconds: 60, cooldownModifierRaw: 4_294_967_296n,
};
```

***

<a id="fleetstatedata"></a>

### FleetStateData

```ts
type FleetStateData = 
  | {
  kind: "idle";
}
  | {
  claimStake: Address;
  endAtUnixSeconds: bigint;
  kind: "claimStakeTransfer";
  load: readonly FleetCargoAmountData[];
  planet: Address;
  unload: readonly FleetCargoAmountData[];
}
  | {
  kind: "destroyed";
}
  | {
  kind: "docked";
  system: Address;
  systemSeqId: bigint;
}
  | {
  asteroid: Address;
  kind: "mining";
  regionXpModifier: number;
  regionXpModifierRaw: bigint;
  resourceIds: readonly number[];
}
  | {
  arrivesAtUnixSeconds: bigint;
  departsAtUnixSeconds: bigint;
  kind: "warp";
  to: WorldCoordinates;
}
  | {
  arrivesAtUnixSeconds: bigint;
  departsAtUnixSeconds: bigint;
  durationSeconds: number;
  durationSecondsRaw: bigint;
  from: WorldCoordinates;
  kind: "subwarp";
  to: WorldCoordinates;
  totalFuelExpenditure: number;
  totalFuelExpenditureRaw: bigint;
  totalXp: number;
  totalXpRaw: bigint;
}
  | {
  kind: "respawn";
  recoversAtUnixSeconds: bigint;
  startedAtUnixSeconds: bigint;
  wasInLowRiskZone: boolean;
};
```

Defined in: [packages/sage/src/internal/c4/fleet.ts:124](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L124)

Stable translated Fleet movement state, exhaustive for the pinned bindings.

#### Example

```ts
declare const state: FleetStateData;
if (state.kind === 'docked') console.log(state.system);
```

***

<a id="fleetwarplanepolicyfailure"></a>

### FleetWarpLanePolicyFailure

```ts
type FleetWarpLanePolicyFailure = 
  | "source-level-zero"
  | "destination-level-zero"
  | "cross-faction-disabled"
  | "foreign-low-risk"
  | "security-zone-access"
  | "region-owner-access";
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:37](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L37)

A bounded policy failure, not a simulation or transaction error.

#### Example

```ts
const reason: FleetWarpLanePolicyFailure = 'foreign-low-risk';
```

## Functions

<a id="derivefleetcoordinatewarpestimate"></a>

### deriveFleetCoordinateWarpEstimate()

```ts
function deriveFleetCoordinateWarpEstimate(input): FleetCoordinateWarpEstimate;
```

Defined in: [packages/sage/src/fleets/coordinate-warp-estimate.ts:69](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/coordinate-warp-estimate.ts#L69)

Estimates a coordinate warp from Idle using deployment-54356023 arithmetic.
Truncates each squared axis before distance calculation, divides duration by
base speed and then modifier, rounds travel and Fuel upward, and adds spool.
Zero speed modifier means neutral. Exact computed maximum range is inclusive.

Coordinates, axis differences and distance must fit signed I8F56, with
distinct endpoints. Speed is positive u32 raw, Fuel rate u32 raw, modifier
nonnegative i64 raw, spool an integer 0..65535 and range u16 raw. Unsupported
inputs are rejected. Tiny distinct points can produce only spool time and
zero Fuel. Out-of-range trips still return estimates with withinRange=false.

No planet-exit surcharge, XP, cooldown, route policy, Fleet state, crew,
permissions or available Fuel are checked. Use the exact encoded destination
and Fleet.locationRaw; simulate the actual Plan before signing. Requalify
after relevant program changes. Use deriveFleetMovementCooldown separately.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetCoordinateWarpEstimateInput`](/reference/fleets/#fleetcoordinatewarpestimateinput) |

#### Returns

[`FleetCoordinateWarpEstimate`](/reference/fleets/#fleetcoordinatewarpestimate)

#### Example

```ts
const estimate = deriveFleetCoordinateWarpEstimate({
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
  spoolSeconds: 3, maxWarpDistanceRaw: 256n,
}); // 4 seconds including spool, 1 Fuel, within range
```

***

<a id="derivefleetmovementcooldown"></a>

### deriveFleetMovementCooldown()

```ts
function deriveFleetMovementCooldown(input): bigint;
```

Defined in: [packages/sage/src/fleets/cooldown.ts:59](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/cooldown.ts#L59)

Predicts the assigned warp-cooldown expiry in Unix seconds for a movement.
Coordinate warp anchors at arrival and rounds the modified base upward;
a zero modifier uses the unmodified base. Lane warp adds no cooldown but
never erases an active one: the expiry becomes the later of the existing
expiry and the departure time. Subwarp preserves the existing expiry.

Coordinate-warp arithmetic is qualified against PTR deployment slot
54356023; the lane rule follows the current program. Coordinate/lane timestamps
must be nonnegative signed-i64 values, base seconds an integer in 0..65535,
and modifier raw a nonnegative signed-i64 value. Overflow is rejected.
An existing expiry may be any signed-i64 value, including sentinels.
This pure helper does not calculate journey duration or check state, active
cooldown, permissions, Fuel or lane eligibility. Use deriveFleetTimers for
observed timer display and simulate the intended action before signing.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetMovementCooldownInput`](/reference/fleets/#fleetmovementcooldowninput) |

#### Returns

`bigint`

#### Example

```ts
const expiry = deriveFleetMovementCooldown({
  kind: 'coordinateWarp', arrivesAtUnixSeconds: 1_800_000_000n,
  baseCooldownSeconds: 61, cooldownModifierRaw: 2_147_483_648n,
}); // 1_800_000_031n
```

***

<a id="derivefleetsubwarpestimate"></a>

### deriveFleetSubwarpEstimate()

```ts
function deriveFleetSubwarpEstimate(input): FleetSubwarpEstimate;
```

Defined in: [packages/sage/src/fleets/subwarp-estimate.ts:73](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/subwarp-estimate.ts#L73)

Estimates direct subwarp duration and recorded fractional Fuel expenditure.
Qualified against PTR deployment slot 54356023, with exact integer rounding
within the supported model. Each squared axis truncates before the square
root; base-speed division precedes modifier division. Modifier zero means 1.

Coordinates, axis differences and distance must fit signed I8F56; endpoints
must differ. Speed is positive u32 raw, Fuel rate u32 raw and modifier
nonnegative i64 raw. These bounds keep intermediate arithmetic within i128.
A route shorter than the program can measure (its squared length truncates
to zero, a displacement below 2^28 raw quanta on both axes) is rejected,
because the program refuses to start such a subwarp.

Applies to departure from Idle, not planet departure, warp or lane travel.
Does not check Fleet state, crew, permissions, tank Fuel, readiness or region
restrictions. Subwarp may start with insufficient Fuel; compare fuelBudget
with the tank and simulate before signing. No planet-exit surcharge or XP is
predicted. Requalify this model after relevant program changes.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetSubwarpEstimateInput`](/reference/fleets/#fleetsubwarpestimateinput) |

#### Returns

[`FleetSubwarpEstimate`](/reference/fleets/#fleetsubwarpestimate)

#### Example

```ts
const journey = deriveFleetSubwarpEstimate({
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
}); // 1 second, budget 1 Fuel
```

***

<a id="derivefleettimers"></a>

### deriveFleetTimers()

```ts
function deriveFleetTimers<TState>(fleet): FleetTimers;
```

Defined in: [packages/sage/src/internal/fleet.ts:334](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L334)

Derives only active Fleet timers; non-positive sentinels and values outside
JavaScript's supported Date range stay absent.

#### Type Parameters

| Type Parameter |
| ------ |
| `TState` *extends* `FleetTimerState` |

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `fleet` | `Pick`\<[`FleetAccountData`](/reference/fleets/#fleetaccountdata), \| `"warpCooldownExpiresAt"` \| `"scanCooldownExpiresAt"` \| `"apReloadExpiresAt"` \| `"shieldBreakDelayExpiresAt"`\> & \{ `state`: `TState`; \} |

#### Returns

[`FleetTimers`](/reference/fleets/#fleettimers)

#### Example

```ts
declare const fleet: FleetSnapshot;
const timers = deriveFleetTimers(fleet);
console.log(
  timers.warpCooldownEndsAt?.toISOString(),
  timers.transferEndsAt?.toISOString(),
);
```

***

<a id="derivefleettravelprofile"></a>

### deriveFleetTravelProfile()

```ts
function deriveFleetTravelProfile(input): FleetTravelProfile;
```

Defined in: [packages/sage/src/fleets/travel-profile.ts:130](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/travel-profile.ts#L130)

Derives reference travel values from Fleet or ship configuration stats,
using the qualified subwarp, coordinate-warp, warp-lane and cooldown
arithmetic (PTR deployment slot 54356023) on one-AU and maximum-range trips
from Idle. Full-tank range inverts the qualified Fuel rate; sustained warp
speed chains maximum-range warps, each waiting out the cooldown assigned at
arrival.

These are reference values, not a route or permission check: no planet
departure, region policy, lane connectivity or toll, crew, XP, active timers
or current tank are considered, and whether a warp may depart with less Fuel
than its debit is not established. A configuration's stats describe one ship;
stats of Fleets mixing configurations are not qualified here.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetTravelProfileInput`](/reference/fleets/#fleettravelprofileinput) |

#### Returns

[`FleetTravelProfile`](/reference/fleets/#fleettravelprofile)

#### Throws

InvalidDerivationInputError for a maximum warp distance of 128 AU or
more, or modifiers and stats outside the movement estimates' bounds.

#### Example

```ts
const profile = deriveFleetTravelProfile({
  stats: {
    movement: {
      subwarpSpeed: { raw: 65536n, value: 1 },
      subwarpFuelConsumptionRate: { raw: 64n, value: 1 },
      warpSpeed: { raw: 65536n, value: 1 },
      warpFuelConsumptionRate: { raw: 128n, value: 2 },
      maxWarpDistance: { raw: 512n, value: 2 },
      warpCoolDownSeconds: 6,
      warpLaneSpeed: { raw: 131072n, value: 2 },
    },
    cargo: { fuelCapacity: 100n },
    combat: { warpSpoolTimeSeconds: 2 },
  },
});
console.log(profile.subwarp?.fullTankRangeAu); // 100
console.log(profile.coordinateWarp?.cycleSeconds); // 10n: 2 spool + 2 travel + 6 cooldown
```

***

<a id="derivefleetwarplaneestimate"></a>

### deriveFleetWarpLaneEstimate()

```ts
function deriveFleetWarpLaneEstimate(input): FleetWarpLaneEstimate;
```

Defined in: [packages/sage/src/fleets/warp-lane-estimate.ts:58](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-estimate.ts#L58)

Estimates lane travel using empirically qualified deployment-54356023 arithmetic.
Truncates each squared axis, computes distance, truncates fixed-point speed
division and rounds duration upward to whole seconds. No Fuel is debited.

Coordinates, axis differences and distance must fit signed I8F56. Speed is
positive u32 raw. Identical and zero-quantized paths are rejected rather than
predicting a successful zero-time lane. Unsupported overflow is rejected.

Supply exact System coordinates and Fleet lane speed, not coordinate-warp
stats. This checks no lane connection, policy, toll, affordability, cooldown,
Fleet state, crew, XP or permissions. Use deriveFleetMovementCooldown for
cooldown separately. Refresh and simulate the Plan before signing; requalify
the arithmetic after relevant program changes.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetWarpLaneEstimateInput`](/reference/fleets/#fleetwarplaneestimateinput) |

#### Returns

[`FleetWarpLaneEstimate`](/reference/fleets/#fleetwarplaneestimate)

#### Example

```ts
const estimate = deriveFleetWarpLaneEstimate({
  fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
  speedRaw: 65536n,
}); // durationSeconds: 1n, fuelDebit: 0n
```

***

<a id="derivefleetwarplanepolicy"></a>

### deriveFleetWarpLanePolicy()

```ts
function deriveFleetWarpLanePolicy(input): FleetWarpLanePolicy;
```

Defined in: [packages/sage/src/fleets/warp-lane-policy.ts:88](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-policy.ts#L88)

Assesses qualified lane policy independently of Plan validation or execution.
Both endpoint owners must equal Fleet faction when cross-faction economics is
disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
its embedded faction; a Safe medium/high region owned by a playable faction
becomes low risk of that owner, while Border and Unaligned-owned regions
retain their tier. Foreign low risk rejects; higher tiers require sufficient
Character access, and entry to a medium/high region owned by another
playable faction also needs the Character's enemy-faction-zone access.
Relationships and combat/territory gates do not block the lane policy.

Only playable factions (the destination region may also be Unaligned) and
known levels/tiers are supported. Resolve the
region containing the destination coordinates before calling: this pure
helper does not perform spatial lookup and does not trust a System region id
on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
permission, toll or available balance. Deployment 54356023 is the empirical
scope; requalify on relevant game changes and simulate before signing.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetWarpLanePolicyInput`](/reference/fleets/#fleetwarplanepolicyinput) |

#### Returns

[`FleetWarpLanePolicy`](/reference/fleets/#fleetwarplanepolicy)

#### Example

```ts
const result = deriveFleetWarpLanePolicy({
  fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
  sourceLevel: 'css', destinationLevel: 'level-1',
  crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
  enemyFactionZoneAccess: false,
  destinationRegion: { owner: 'oni', safety: 'safe',
    risk: { kind: 'low', faction: 'oni' } },
}); // passesPolicy: true; still simulate the actual Plan
```

***

<a id="derivefleetwarplanetoll"></a>

### deriveFleetWarpLaneToll()

```ts
function deriveFleetWarpLaneToll(input): FleetWarpLaneToll;
```

Defined in: [packages/sage/src/fleets/warp-lane-toll.ts:79](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/warp-lane-toll.ts#L79)

Estimates the Character ATLAS toll using deployment-54356023 lane rules.
Selects cost by departure level. Ceils the Character-modified base, then adds
a separately floored surcharge on the unmodified base if either endpoint is
foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
A foreign source with own destination uses neutral bps. Modifier zero waives
only the modified base. Relationship expiry does not alter the measured toll.

Accepts playable factions only, usable source levels, u64 raw base cost,
nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
No RPC, balance, connection, region, permission or execution checks occur.
ATLAS is paid from Character, not wallet. Requalify after program changes.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `input` | [`FleetWarpLaneTollInput`](/reference/fleets/#fleetwarplanetollinput) |

#### Returns

[`FleetWarpLaneToll`](/reference/fleets/#fleetwarplanetoll)

#### Example

```ts
declare const input: FleetWarpLaneTollInput;
const toll = deriveFleetWarpLaneToll(input);
console.log(toll.totalRaw);
```

***

<a id="discoverfleetaddresses"></a>

### discoverFleetAddresses()

```ts
function discoverFleetAddresses(ctx, options?): Promise<readonly Address[]>;
```

Defined in: [packages/sage/src/fleets/index.ts:376](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L376)

Discovers every Fleet address for the configured Game.

The existing discovery data plane downloads and validates complete Fleet
account bytes before exposing an address. It does not hydrate Fleet
snapshots or load ship, cargo, or Game registry definitions.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `options?` | [`FleetDiscoveryOptions`](/reference/fleets/#fleetdiscoveryoptions) |

#### Returns

`Promise`\<readonly [`Address`](/reference/#address-20)[]\>

#### Example

```ts
declare const ctx: SageContext;
const fleetAddresses = await discoverFleetAddresses(ctx);
console.log(fleetAddresses, readMeta(fleetAddresses)?.strategy);
```

***

<a id="getfleet"></a>

### getFleet()

```ts
function getFleet(
   ctx, 
   address, 
options?): Promise<FleetSnapshot>;
```

Defined in: [packages/sage/src/fleets/index.ts:218](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L218)

Reads a required Fleet by account address.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-20) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`FleetSnapshot`](/reference/fleets/#fleetsnapshot)\>

#### Example

```ts
declare const ctx: SageContext;
declare const fleetAddress: Address;
const fleet = await getFleet(ctx, fleetAddress);
```

***

<a id="getfleets"></a>

### getFleets()

```ts
function getFleets(
   ctx, 
   addresses, 
options?): Promise<readonly FleetSnapshot[]>;
```

Defined in: [packages/sage/src/fleets/index.ts:245](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L245)

Reads required Fleets by account address in one batched data-plane request.

The frozen result preserves input order and duplicate positions. Every
requested address must exist; use separate optional reads when absence is an
expected outcome.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `addresses` | readonly [`Address`](/reference/#address-20)[] |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<readonly [`FleetSnapshot`](/reference/fleets/#fleetsnapshot)[]\>

#### Example

```ts
declare const ctx: SageContext;
declare const fleetAddresses: readonly Address[];
const fleets = await getFleets(ctx, fleetAddresses);
```

***

<a id="getfleetsbyowner"></a>

### getFleetsByOwner()

```ts
function getFleetsByOwner(
   ctx, 
   profileAddress, 
options?): Promise<readonly FleetSnapshot[]>;
```

Defined in: [packages/sage/src/fleets/index.ts:350](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L350)

Discovers Fleets owned by a known Player Profile using targeted stable filters.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `profileAddress` | [`Address`](/reference/#address-20) |
| `options?` | [`FleetDiscoveryOptions`](/reference/fleets/#fleetdiscoveryoptions) |

#### Returns

`Promise`\<readonly [`FleetSnapshot`](/reference/fleets/#fleetsnapshot)[]\>

#### Example

```ts
declare const ctx: SageContext;
declare const profileAddress: Address;
const fleets = await getFleetsByOwner(ctx, profileAddress);
```

***

<a id="interpolatesubwarpposition"></a>

### interpolateSubwarpPosition()

```ts
function interpolateSubwarpPosition(state, atUnixSeconds): SubwarpPosition;
```

Defined in: [packages/sage/src/internal/fleet.ts:401](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L401)

Interpolates a display-only subwarp position, clamped to both endpoints.

The result must not be used as authoritative on-chain position state.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `state` | \{ `arrivesAtUnixSeconds`: `bigint`; `departsAtUnixSeconds`: `bigint`; `durationSeconds`: `number`; `durationSecondsRaw`: `bigint`; `from`: [`WorldCoordinates`](/reference/fleets/#worldcoordinates); `kind`: `"subwarp"`; `to`: [`WorldCoordinates`](/reference/fleets/#worldcoordinates); `totalFuelExpenditure`: `number`; `totalFuelExpenditureRaw`: `bigint`; `totalXp`: `number`; `totalXpRaw`: `bigint`; \} |
| `state.arrivesAtUnixSeconds` | `bigint` |
| `state.departsAtUnixSeconds` | `bigint` |
| `state.durationSeconds` | `number` |
| `state.durationSecondsRaw` | `bigint` |
| `state.from` | [`WorldCoordinates`](/reference/fleets/#worldcoordinates) |
| `state.kind` | `"subwarp"` |
| `state.to` | [`WorldCoordinates`](/reference/fleets/#worldcoordinates) |
| `state.totalFuelExpenditure` | `number` |
| `state.totalFuelExpenditureRaw` | `bigint` |
| `state.totalXp` | `number` |
| `state.totalXpRaw` | `bigint` |
| `atUnixSeconds` | `bigint` |

#### Returns

[`SubwarpPosition`](/reference/fleets/#subwarpposition)

#### Example

```ts
declare const state: Extract<FleetStateData, { readonly kind: 'subwarp' }>;
const position = interpolateSubwarpPosition(state, 1_700_000_000n);
console.log(position.position, position.progress);
```

***

<a id="maybegetfleet"></a>

### maybeGetFleet()

```ts
function maybeGetFleet(
   ctx, 
   address, 
options?): Promise<FleetSnapshot | undefined>;
```

Defined in: [packages/sage/src/fleets/index.ts:278](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L278)

Reads an optional Fleet by account address.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-20) |
| `options?` | [`ReadOptions`](/reference/client/#readoptions) |

#### Returns

`Promise`\<[`FleetSnapshot`](/reference/fleets/#fleetsnapshot) \| `undefined`\>

#### Example

```ts
declare const ctx: SageContext;
declare const fleetAddress: Address;
const fleet = await maybeGetFleet(ctx, fleetAddress);
```

***

<a id="watchfleet"></a>

### watchFleet()

```ts
function watchFleet(
   ctx, 
   address, 
   observer, 
options?): Promise<SageSubscription>;
```

Defined in: [packages/sage/src/fleets/index.ts:308](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L308)

Watches one Fleet through its context-owned WebSocket subscription.

Registration emits the current validated Fleet first, then only selected
slot/commitment advances. Unsubscribe explicitly or dispose the context.

#### Parameters

| Parameter | Type |
| ------ | ------ |
| `ctx` | [`SageContext`](/reference/#sagecontext) |
| `address` | [`Address`](/reference/#address-20) |
| `observer` | [`FleetSubscriptionObserver`](/reference/fleets/#fleetsubscriptionobserver) |
| `options?` | [`ReadAccountOptions`](/reference/client/#readaccountoptions) |

#### Returns

`Promise`\<[`SageSubscription`](/reference/#sagesubscription)\>

#### Example

```ts
declare const ctx: SageContext;
declare const fleetAddress: Address;
const subscription = await watchFleet(ctx, fleetAddress, {
  onSnapshot: fleet => console.log(fleet.name),
  onError: error => console.error(error.code),
});
await subscription.unsubscribe();
```

## References

<a id="fleetcombatstatsdata"></a>

### FleetCombatStatsData

Re-exports [FleetCombatStatsData](/reference/combat/#fleetcombatstatsdata)

***

<a id="listshipconfigurations"></a>

### listShipConfigurations

Re-exports [listShipConfigurations](/reference/#listshipconfigurations)

***

<a id="listshipconfigurationsbymint"></a>

### listShipConfigurationsByMint

Re-exports [listShipConfigurationsByMint](/reference/#listshipconfigurationsbymint)