# 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:324](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L324)

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:357](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L357)

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

##### ammoBank

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

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="ap"></a>

##### ap

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

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="apreloadexpiresat"></a>

##### apReloadExpiresAt

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

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="bump"></a>

##### bump

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

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

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

##### cargoHold

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

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="components"></a>

##### components

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

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="crewcount"></a>

##### crewCount

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

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="faction"></a>

##### faction

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

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="fleetships"></a>

##### fleetShips

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

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="fueltank"></a>

##### fuelTank

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

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="game"></a>

##### game

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

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

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

##### hp

```ts
readonly hp: 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="lastcombatupdate"></a>

##### lastCombatUpdate

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

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="lastupdateat"></a>

##### lastUpdateAt

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

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)

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

##### location

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

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="name"></a>

##### name

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

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="npcfactionid"></a>

##### npcFactionId

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

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="ownerprofile"></a>

##### ownerProfile

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

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

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

##### pendingHp

```ts
readonly pendingHp: 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="rentedcrew"></a>

##### rentedCrew

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

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="respawningcargo"></a>

##### respawningCargo

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

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="scancooldownexpiresat"></a>

##### scanCooldownExpiresAt

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

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="shieldbreakdelayexpiresat"></a>

##### shieldBreakDelayExpiresAt

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

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="shipcounts"></a>

##### shipCounts

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

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="shipdefinitionsseqid"></a>

##### shipDefinitionsSeqId

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

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="sp"></a>

##### sp

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

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="stance"></a>

##### stance

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

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)

###### 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:362](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L362)

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

##### stats

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

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="subprofile"></a>

##### subProfile

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

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)

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

##### subProfileInvalidator

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

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="version"></a>

##### version

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

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

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

##### warpCooldownExpiresAt

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

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="fleetcargoamountdata"></a>

### FleetCargoAmountData

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)

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:84](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L84)

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

##### cargoId

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

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="fleetcargopoddata"></a>

### FleetCargoPodData

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)

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:97](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L97)

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

##### seqId

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

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="storagecost"></a>

##### storageCost

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

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

***

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

### FleetCargoStatsData

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

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:217](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L217)

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

##### ammoConsumptionRate

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

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

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

##### cargoCapacity

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

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

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

##### foodConsumptionRate

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

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

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

##### fuelCapacity

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

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

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

##### loadRate

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

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

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

##### miningRate

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

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

***

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

### FleetFixedValue

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 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:71](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L71)

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

##### value

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

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

***

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

### FleetMiscStatsData

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

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:298](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L298)

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

##### medallionValue

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

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)

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

##### passengerCapacity

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

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)

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

##### requiredCrew

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

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

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

##### respawnFeeAtlas

```ts
readonly respawnFeeAtlas: 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="respawnfeeraw"></a>

##### respawnFeeRaw

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

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="respawntimewithfeeseconds"></a>

##### respawnTimeWithFeeSeconds

```ts
readonly respawnTimeWithFeeSeconds: 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="respawntimewithoutfeeseconds"></a>

##### respawnTimeWithoutFeeSeconds

```ts
readonly respawnTimeWithoutFeeSeconds: 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="scanbonus"></a>

##### scanBonus

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

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)

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

##### scanCoolDownSeconds

```ts
readonly scanCoolDownSeconds: number;
```

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="scancost"></a>

##### scanCost

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

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

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

##### scanPower

```ts
readonly scanPower: 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="xpvalue"></a>

##### xpValue

```ts
readonly xpValue: 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="fleetmovementstatsdata"></a>

### FleetMovementStatsData

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

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:198](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L198)

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

##### planetExitFuelAmount

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

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="subwarpfuelconsumptionrate"></a>

##### subwarpFuelConsumptionRate

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

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)

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

##### subwarpSpeed

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

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

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

##### subwarpXpRate

```ts
readonly subwarpXpRate: 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="warpcooldownseconds"></a>

##### warpCoolDownSeconds

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

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

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

##### warpFuelConsumptionRate

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

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="warplanespeed"></a>

##### warpLaneSpeed

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

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

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

##### warpSpeed

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

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

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

##### warpXpRate

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

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="fleetshipamountdata"></a>

### FleetShipAmountData

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)

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:109](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L109)

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

##### shipId

```ts
readonly shipId: 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="fleetshipcountsdata"></a>

### FleetShipCountsData

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

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:126](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L126)

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

##### commander

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

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

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

##### large

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

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

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

##### medium

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

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)

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

##### small

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

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

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

##### titan

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

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

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

##### total

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

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

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

##### xSmall

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

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

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

##### xxSmall

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

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

***

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

### FleetSnapshot

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

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:357](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L357)

###### 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:92](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L92)

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

##### ammo

```ts
readonly ammo: 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).[`ammo`](/reference/fleets/#resolvedfleetaccountdata)

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

##### ap

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

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)

###### 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:348](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L348)

###### 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:326](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L326)

###### 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:118](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L118)

###### 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:103](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L103)

###### 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:108](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L108)

###### 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:340](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L340)

###### 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:331](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L331)

###### 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:101](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L101)

###### 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:327](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L327)

###### 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:345](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L345)

###### 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:91](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L91)

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

##### lastCombatUpdate

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

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).[`lastCombatUpdate`](/reference/fleets/#fleetaccountdata)

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

##### lastUpdateAt

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

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)

###### 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:351](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L351)

###### Inherited from

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

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

##### name

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

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).[`name`](/reference/fleets/#fleetaccountdata)

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

##### npcFactionId

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

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).[`npcFactionId`](/reference/fleets/#fleetaccountdata)

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

##### ownerProfile

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

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

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

##### pendingHp

```ts
readonly pendingHp: 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).[`pendingHp`](/reference/fleets/#fleetaccountdata)

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

##### rentedCrew

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

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).[`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:113](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L113)

###### 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:336](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L336)

###### 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:349](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L349)

###### 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:334](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L334)

###### 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:342](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L342)

###### 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:100](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L100)

###### Inherited from

```ts
Omit.ships
```

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

##### sp

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

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)

###### 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:347](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L347)

###### 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:123](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L123)

###### 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:337](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L337)

###### 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:99](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L99)

###### Inherited from

```ts
Omit.subProfileInvalidator
```

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

##### version

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

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

###### 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:335](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L335)

###### Inherited from

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

#### Methods

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

##### toJSON()

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

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

###### Returns

`unknown`

***

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

### FleetStatsData

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

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:312](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L312)

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

##### combat

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

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

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

##### misc

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

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

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

##### movement

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

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

***

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

### FleetSubscriptionObserver

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

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:111](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L111)

###### 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:110](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L110)

###### 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:109](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L109)

###### Parameters

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

###### Returns

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

***

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

### FleetTimers

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

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:291](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L291)

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

##### arrivesAt?

```ts
readonly optional arrivesAt?: 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="recoversat"></a>

##### recoversAt?

```ts
readonly optional recoversAt?: 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="scancooldownendsat"></a>

##### scanCooldownEndsAt?

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

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

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

##### shieldRegenerationResumesAt?

```ts
readonly optional shieldRegenerationResumesAt?: 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="transferendsat"></a>

##### transferEndsAt?

```ts
readonly optional transferEndsAt?: 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="warpcooldownendsat"></a>

##### warpCooldownEndsAt?

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

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

***

<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:357](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L357)

###### 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:102](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L102)

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

##### ap

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

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)

###### 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:348](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L348)

###### 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:326](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L326)

###### 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:118](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L118)

###### 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:103](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L103)

###### 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:108](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L108)

###### 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:340](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L340)

###### 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:331](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L331)

###### 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:101](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L101)

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

##### game

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

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

###### 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:345](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L345)

###### 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:350](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L350)

###### 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:352](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L352)

###### 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:351](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L351)

###### Inherited from

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

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

##### name

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

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).[`name`](/reference/fleets/#fleetaccountdata)

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

##### npcFactionId

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

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).[`npcFactionId`](/reference/fleets/#fleetaccountdata)

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

##### ownerProfile

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

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

###### 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:346](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L346)

###### 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:341](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L341)

###### 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:113](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L113)

###### 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:336](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L336)

###### 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:349](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L349)

###### 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:334](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L334)

###### 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:342](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L342)

###### 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:100](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L100)

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

##### sp

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

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)

###### 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:347](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L347)

###### 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:123](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L123)

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

##### stats

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

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).[`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:99](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L99)

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

##### version

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

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

###### 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:335](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L335)

###### Inherited from

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

***

<a id="subwarpposition"></a>

### SubwarpPosition

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

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:382](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L382)

<a id="position"></a>

##### position

```ts
readonly position: WorldCoordinates;
```

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

<a id="progress"></a>

##### progress

```ts
readonly progress: number;
```

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

***

<a id="worldcoordinates"></a>

### WorldCoordinates

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

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:129](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/world.ts#L129)

<a id="y"></a>

##### y

```ts
readonly y: number;
```

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

## Type Aliases

<a id="fleetdiscoveryoptions"></a>

### FleetDiscoveryOptions

```ts
type FleetDiscoveryOptions = Omit<DiscoveryRequest, "filters" | "strategy">;
```

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

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="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:138](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/c4/fleet.ts#L138)

Stable translated Fleet movement state, exhaustive for the pinned bindings.

#### Example

```ts
declare const state: FleetStateData;
if (state.kind === 'docked') console.log(state.system);
```

## Functions

<a id="derivefleettimers"></a>

### deriveFleetTimers()

```ts
function deriveFleetTimers<TState>(fleet): FleetTimers;
```

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

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="getfleet"></a>

### getFleet()

```ts
function getFleet(
   ctx, 
   address, 
options?): Promise<FleetSnapshot>;
```

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

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="getfleetsbyowner"></a>

### getFleetsByOwner()

```ts
function getFleetsByOwner(
   ctx, 
   profileAddress, 
options?): Promise<readonly FleetSnapshot[]>;
```

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

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:398](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/internal/fleet.ts#L398)

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:214](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L214)

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:244](https://github.com/Aephia/atlas-kit/blob/develop/packages/sage/src/fleets/index.ts#L244)

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)