@solana-mobile/guardian-client 0.0.0-stage → 0.1.0

package/dist/types/generated/programs/guardian.d.ts

@@ -0,0 +1,179 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type ClientWithRpc, type ClientWithTransactionPlanning, type ClientWithTransactionSending, type ExtendedClient, type GetAccountInfoApi, type GetMultipleAccountsApi, type HasAddress, type Instruction, type InstructionWithData, type ReadonlyUint8Array } from '@solana/kit';
+import { type SelfFetchFunctions, type SelfPlanAndSendFunctions } from '@solana/program-client-core';
+import { getAppAccountCodec, getGuardiansConfigCodec, getPendingRegistryCodec, type AppAccount, type AppAccountArgs, type GuardiansConfig, type GuardiansConfigArgs, type PendingRegistry, type PendingRegistryArgs } from '../accounts';
+import { getAcceptAppAuthorityInstructionAsync, getAcceptConfigAuthorityInstructionAsync, getAddGuardianInstructionAsync, getCancelReleaseInstructionAsync, getExpireReleaseInstructionAsync, getInitializeConfigInstructionAsync, getProposeAppAuthorityInstructionAsync, getProposeConfigAuthorityInstructionAsync, getProposeReleaseInstructionAsync, getRegisterAppInstructionAsync, getRegisterGuardianInstructionAsync, getRemoveGuardianInstructionAsync, getRotateVoteAuthorityInstructionAsync, getSetAppDeveloperInstructionAsync, getUpdateConfigInstructionAsync, getVoteInstructionAsync, getWriteReleaseManifestInstructionAsync, type AcceptAppAuthorityAsyncInput, type AcceptConfigAuthorityAsyncInput, type AddGuardianAsyncInput, type CancelReleaseAsyncInput, type ExpireReleaseAsyncInput, type InitializeConfigAsyncInput, type ParsedAcceptAppAuthorityInstruction, type ParsedAcceptConfigAuthorityInstruction, type ParsedAddGuardianInstruction, type ParsedCancelReleaseInstruction, type ParsedExpireReleaseInstruction, type ParsedInitializeConfigInstruction, type ParsedProposeAppAuthorityInstruction, type ParsedProposeConfigAuthorityInstruction, type ParsedProposeReleaseInstruction, type ParsedRegisterAppInstruction, type ParsedRegisterGuardianInstruction, type ParsedRemoveGuardianInstruction, type ParsedRotateVoteAuthorityInstruction, type ParsedSetAppDeveloperInstruction, type ParsedUpdateConfigInstruction, type ParsedVoteInstruction, type ParsedWriteReleaseManifestInstruction, type ProposeAppAuthorityAsyncInput, type ProposeConfigAuthorityAsyncInput, type ProposeReleaseAsyncInput, type RegisterAppAsyncInput, type RegisterGuardianAsyncInput, type RemoveGuardianAsyncInput, type RotateVoteAuthorityAsyncInput, type SetAppDeveloperAsyncInput, type UpdateConfigAsyncInput, type VoteAsyncInput, type WriteReleaseManifestAsyncInput } from '../instructions';
+import { findBondVaultPda, findGuardiansConfigPda, findPendingRegistryPda } from '../pdas';
+export declare const GUARDIAN_PROGRAM_ADDRESS: Address<"GUARDsVUfAaydbPU6QGcpWRLUkExaULtaygwEtkdhZAD">;
+export declare enum GuardianAccount {
+    AppAccount = 0,
+    GuardiansConfig = 1,
+    PendingRegistry = 2
+}
+export declare function identifyGuardianAccount(account: {
+    data: ReadonlyUint8Array;
+} | ReadonlyUint8Array): GuardianAccount;
+export declare enum GuardianEvent {
+    AppAuthorityAccepted = 0,
+    AppAuthorityProposed = 1,
+    AppDeveloperUpdated = 2,
+    AppRegistered = 3,
+    ConfigAuthorityAccepted = 4,
+    ConfigAuthorityProposed = 5,
+    ConfigInitialized = 6,
+    ConfigUpdated = 7,
+    GuardianAdded = 8,
+    GuardianRegistered = 9,
+    GuardianRemoved = 10,
+    GuardianVoteAuthorityRotated = 11,
+    ReleaseApproved = 12,
+    ReleaseCancelled = 13,
+    ReleaseExpired = 14,
+    ReleaseProposed = 15,
+    ReleaseRejected = 16,
+    VoteCast = 17
+}
+export declare function identifyGuardianEvent(event: {
+    data: ReadonlyUint8Array;
+} | ReadonlyUint8Array): GuardianEvent;
+export declare enum GuardianInstruction {
+    AcceptAppAuthority = 0,
+    AcceptConfigAuthority = 1,
+    AddGuardian = 2,
+    CancelRelease = 3,
+    ExpireRelease = 4,
+    InitializeConfig = 5,
+    ProposeAppAuthority = 6,
+    ProposeConfigAuthority = 7,
+    ProposeRelease = 8,
+    RegisterApp = 9,
+    RegisterGuardian = 10,
+    RemoveGuardian = 11,
+    RotateVoteAuthority = 12,
+    SetAppDeveloper = 13,
+    UpdateConfig = 14,
+    Vote = 15,
+    WriteReleaseManifest = 16
+}
+export declare function identifyGuardianInstruction(instruction: {
+    data: ReadonlyUint8Array;
+} | ReadonlyUint8Array): GuardianInstruction;
+export type ParsedGuardianInstruction<TProgram extends string = 'GUARDsVUfAaydbPU6QGcpWRLUkExaULtaygwEtkdhZAD'> = ({
+    instructionType: GuardianInstruction.AcceptAppAuthority;
+} & ParsedAcceptAppAuthorityInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.AcceptConfigAuthority;
+} & ParsedAcceptConfigAuthorityInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.AddGuardian;
+} & ParsedAddGuardianInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.CancelRelease;
+} & ParsedCancelReleaseInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.ExpireRelease;
+} & ParsedExpireReleaseInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.InitializeConfig;
+} & ParsedInitializeConfigInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.ProposeAppAuthority;
+} & ParsedProposeAppAuthorityInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.ProposeConfigAuthority;
+} & ParsedProposeConfigAuthorityInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.ProposeRelease;
+} & ParsedProposeReleaseInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.RegisterApp;
+} & ParsedRegisterAppInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.RegisterGuardian;
+} & ParsedRegisterGuardianInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.RemoveGuardian;
+} & ParsedRemoveGuardianInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.RotateVoteAuthority;
+} & ParsedRotateVoteAuthorityInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.SetAppDeveloper;
+} & ParsedSetAppDeveloperInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.UpdateConfig;
+} & ParsedUpdateConfigInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.Vote;
+} & ParsedVoteInstruction<TProgram>) | ({
+    instructionType: GuardianInstruction.WriteReleaseManifest;
+} & ParsedWriteReleaseManifestInstruction<TProgram>);
+export declare function parseGuardianInstruction<TProgram extends string>(instruction: Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array>): ParsedGuardianInstruction<TProgram>;
+export type GuardianPlugin = {
+    accounts: GuardianPluginAccounts;
+    instructions: GuardianPluginInstructions;
+    pdas: GuardianPluginPdas;
+    identifyAccount: typeof identifyGuardianAccount;
+    identifyInstruction: typeof identifyGuardianInstruction;
+    parseInstruction: typeof parseGuardianInstruction;
+};
+export type GuardianPluginAccounts = {
+    appAccount: ReturnType<typeof getAppAccountCodec> & SelfFetchFunctions<AppAccountArgs, AppAccount>;
+    guardiansConfig: ReturnType<typeof getGuardiansConfigCodec> & SelfFetchFunctions<GuardiansConfigArgs, GuardiansConfig>;
+    pendingRegistry: ReturnType<typeof getPendingRegistryCodec> & SelfFetchFunctions<PendingRegistryArgs, PendingRegistry>;
+};
+export type GuardianPluginInstructions = {
+    acceptAppAuthority: (input: AcceptAppAuthorityAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getAcceptAppAuthorityInstructionAsync> & SelfPlanAndSendFunctions;
+    acceptConfigAuthority: (input: AcceptConfigAuthorityAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getAcceptConfigAuthorityInstructionAsync> & SelfPlanAndSendFunctions;
+    addGuardian: (input: AddGuardianAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getAddGuardianInstructionAsync> & SelfPlanAndSendFunctions;
+    cancelRelease: (input: CancelReleaseAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getCancelReleaseInstructionAsync> & SelfPlanAndSendFunctions;
+    expireRelease: (input: ExpireReleaseAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getExpireReleaseInstructionAsync> & SelfPlanAndSendFunctions;
+    initializeConfig: (input: InitializeConfigAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getInitializeConfigInstructionAsync> & SelfPlanAndSendFunctions;
+    proposeAppAuthority: (input: ProposeAppAuthorityAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getProposeAppAuthorityInstructionAsync> & SelfPlanAndSendFunctions;
+    proposeConfigAuthority: (input: ProposeConfigAuthorityAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getProposeConfigAuthorityInstructionAsync> & SelfPlanAndSendFunctions;
+    proposeRelease: (input: ProposeReleaseAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getProposeReleaseInstructionAsync> & SelfPlanAndSendFunctions;
+    registerApp: (input: RegisterAppAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getRegisterAppInstructionAsync> & SelfPlanAndSendFunctions;
+    registerGuardian: (input: RegisterGuardianAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getRegisterGuardianInstructionAsync> & SelfPlanAndSendFunctions;
+    removeGuardian: (input: RemoveGuardianAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getRemoveGuardianInstructionAsync> & SelfPlanAndSendFunctions;
+    rotateVoteAuthority: (input: RotateVoteAuthorityAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getRotateVoteAuthorityInstructionAsync> & SelfPlanAndSendFunctions;
+    setAppDeveloper: (input: SetAppDeveloperAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getSetAppDeveloperInstructionAsync> & SelfPlanAndSendFunctions;
+    updateConfig: (input: UpdateConfigAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getUpdateConfigInstructionAsync> & SelfPlanAndSendFunctions;
+    vote: (input: VoteAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getVoteInstructionAsync> & SelfPlanAndSendFunctions;
+    writeReleaseManifest: (input: WriteReleaseManifestAsyncInput, config?: {
+        programAddress?: Address | HasAddress;
+    }) => ReturnType<typeof getWriteReleaseManifestInstructionAsync> & SelfPlanAndSendFunctions;
+};
+export type GuardianPluginPdas = {
+    guardiansConfig: typeof findGuardiansConfigPda;
+    pendingRegistry: typeof findPendingRegistryPda;
+    bondVault: typeof findBondVaultPda;
+};
+export type GuardianPluginRequirements = ClientWithRpc<GetAccountInfoApi & GetMultipleAccountsApi> & ClientWithTransactionPlanning & ClientWithTransactionSending;
+export declare function guardianProgram(config?: {
+    programAddress?: Address | HasAddress;
+}): <T extends GuardianPluginRequirements>(client: T) => ExtendedClient<T, {
+    guardian: GuardianPlugin;
+}>;

package/dist/types/generated/programs/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+export * from './guardian';

package/dist/types/generated/types/bondInfo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type HasAddress } from '@solana/kit';
+export type BondInfo = {
+    mint: Address;
+    amount: bigint;
+};
+export type BondInfoArgs = {
+    mint: Address | HasAddress;
+    amount: number | bigint;
+};
+export declare function getBondInfoEncoder(): FixedSizeEncoder<BondInfoArgs>;
+export declare function getBondInfoDecoder(): FixedSizeDecoder<BondInfo>;
+export declare function getBondInfoCodec(): FixedSizeCodec<BondInfoArgs, BondInfo>;

package/dist/types/generated/types/guardianInfo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type HasAddress } from '@solana/kit';
+export type GuardianInfo = {
+    voteAuthority: Address;
+    bond: bigint;
+};
+export type GuardianInfoArgs = {
+    voteAuthority: Address | HasAddress;
+    bond: number | bigint;
+};
+export declare function getGuardianInfoEncoder(): FixedSizeEncoder<GuardianInfoArgs>;
+export declare function getGuardianInfoDecoder(): FixedSizeDecoder<GuardianInfo>;
+export declare function getGuardianInfoCodec(): FixedSizeCodec<GuardianInfoArgs, GuardianInfo>;

package/dist/types/generated/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+export * from './bondInfo';
+export * from './guardianInfo';
+export * from './pendingRelease';
+export * from './publishedApp';
+export * from './releaseManifest';
+export * from './releaseResolution';
+export * from './voteFinding';

package/dist/types/generated/types/pendingRelease.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Codec, type Decoder, type Encoder, type GetDiscriminatedUnionVariant, type GetDiscriminatedUnionVariantContent } from '@solana/kit';
+import { type ReleaseManifest, type ReleaseManifestArgs } from '.';
+export type PendingRelease = {
+    __kind: 'None';
+} | {
+    __kind: 'Pending';
+    fields: readonly [ReleaseManifest];
+};
+export type PendingReleaseArgs = {
+    __kind: 'None';
+} | {
+    __kind: 'Pending';
+    fields: readonly [ReleaseManifestArgs];
+};
+export declare function getPendingReleaseEncoder(): Encoder<PendingReleaseArgs>;
+export declare function getPendingReleaseDecoder(): Decoder<PendingRelease>;
+export declare function getPendingReleaseCodec(): Codec<PendingReleaseArgs, PendingRelease>;
+export declare function pendingRelease(kind: 'None'): GetDiscriminatedUnionVariant<PendingReleaseArgs, '__kind', 'None'>;
+export declare function pendingRelease(kind: 'Pending', data: GetDiscriminatedUnionVariantContent<PendingReleaseArgs, '__kind', 'Pending'>['fields']): GetDiscriminatedUnionVariant<PendingReleaseArgs, '__kind', 'Pending'>;
+export declare function isPendingRelease<K extends PendingRelease['__kind']>(kind: K, value: PendingRelease): value is PendingRelease & {
+    __kind: K;
+};

package/dist/types/generated/types/publishedApp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type ReadonlyUint8Array } from '@solana/kit';
+export type PublishedApp = {
+    versionCode: number;
+    manifestHash: ReadonlyUint8Array;
+};
+export type PublishedAppArgs = PublishedApp;
+export declare function getPublishedAppEncoder(): FixedSizeEncoder<PublishedAppArgs>;
+export declare function getPublishedAppDecoder(): FixedSizeDecoder<PublishedApp>;
+export declare function getPublishedAppCodec(): FixedSizeCodec<PublishedAppArgs, PublishedApp>;

package/dist/types/generated/types/releaseManifest.d.ts

@@ -0,0 +1,45 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type Codec, type Decoder, type Encoder, type HasAddress, type ReadonlyUint8Array } from '@solana/kit';
+export type ReleaseManifest = {
+    versionCode: number;
+    finalized: boolean;
+    guardianNonce: number;
+    manifestHash: ReadonlyUint8Array;
+    policyBundleHash: ReadonlyUint8Array;
+    resolved: boolean;
+    approved: boolean;
+    quorumTs: bigint;
+    votingDeadline: bigint;
+    finalizeTs: bigint;
+    finalizeSeq: bigint;
+    previousFinalizeTs: bigint;
+    certificateSha256: ReadonlyUint8Array;
+    data: ReadonlyUint8Array;
+    votes: Map<Address, boolean>;
+};
+export type ReleaseManifestArgs = {
+    versionCode: number;
+    finalized: boolean;
+    guardianNonce: number;
+    manifestHash: ReadonlyUint8Array;
+    policyBundleHash: ReadonlyUint8Array;
+    resolved: boolean;
+    approved: boolean;
+    quorumTs: number | bigint;
+    votingDeadline: number | bigint;
+    finalizeTs: number | bigint;
+    finalizeSeq: number | bigint;
+    previousFinalizeTs: number | bigint;
+    certificateSha256: ReadonlyUint8Array;
+    data: ReadonlyUint8Array;
+    votes: Map<Address | HasAddress, boolean>;
+};
+export declare function getReleaseManifestEncoder(): Encoder<ReleaseManifestArgs>;
+export declare function getReleaseManifestDecoder(): Decoder<ReleaseManifest>;
+export declare function getReleaseManifestCodec(): Codec<ReleaseManifestArgs, ReleaseManifest>;

package/dist/types/generated/types/releaseResolution.d.ts

@@ -0,0 +1,65 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Address, type Codec, type Decoder, type Encoder, type HasAddress, type ReadonlyUint8Array } from '@solana/kit';
+/**
+ * A resolved release, with its manifest and voters. Late votes aren't included; each one gets its
+ * own `VoteCast`.
+ */
+export type ReleaseResolution = {
+    /** The wrapping event's `VERSION`. */
+    version: number;
+    /** Position in the app's event sequence. */
+    seq: bigint;
+    /** The app account. */
+    app: Address;
+    /** Version code of the resolved release. */
+    versionCode: number;
+    /** sha256 of `manifest`. */
+    manifestHash: ReadonlyUint8Array;
+    /**
+     * The release's signing certificate hash. Copied to the app's `signing_certificate` on
+     * approval.
+     */
+    certificateSha256: ReadonlyUint8Array;
+    /** Guardian-set nonce the votes were cast under. */
+    guardianNonce: number;
+    /** Authority keys of the guardians that approved, sorted. */
+    approvals: Array<Address>;
+    /** Authority keys of the guardians that rejected, sorted. */
+    rejections: Array<Address>;
+    /** Full manifest bytes. */
+    manifest: ReadonlyUint8Array;
+};
+export type ReleaseResolutionArgs = {
+    /** The wrapping event's `VERSION`. */
+    version: number;
+    /** Position in the app's event sequence. */
+    seq: number | bigint;
+    /** The app account. */
+    app: Address | HasAddress;
+    /** Version code of the resolved release. */
+    versionCode: number;
+    /** sha256 of `manifest`. */
+    manifestHash: ReadonlyUint8Array;
+    /**
+     * The release's signing certificate hash. Copied to the app's `signing_certificate` on
+     * approval.
+     */
+    certificateSha256: ReadonlyUint8Array;
+    /** Guardian-set nonce the votes were cast under. */
+    guardianNonce: number;
+    /** Authority keys of the guardians that approved, sorted. */
+    approvals: Array<Address | HasAddress>;
+    /** Authority keys of the guardians that rejected, sorted. */
+    rejections: Array<Address | HasAddress>;
+    /** Full manifest bytes. */
+    manifest: ReadonlyUint8Array;
+};
+export declare function getReleaseResolutionEncoder(): Encoder<ReleaseResolutionArgs>;
+export declare function getReleaseResolutionDecoder(): Decoder<ReleaseResolution>;
+export declare function getReleaseResolutionCodec(): Codec<ReleaseResolutionArgs, ReleaseResolution>;

package/dist/types/generated/types/voteFinding.d.ts

@@ -0,0 +1,24 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+import { type Codec, type Decoder, type Encoder } from '@solana/kit';
+/**
+ * A finding reported with a vote. `code` indexes the taxonomy of the vote's policy bundle. The
+ * program doesn't interpret findings.
+ */
+export type VoteFinding = {
+    /** Index of the finding code in the policy bundle's taxonomy. */
+    code: number;
+    /** Check outcome, encoded by the voter. */
+    status: number;
+    /** Free-text detail. */
+    detail: string;
+};
+export type VoteFindingArgs = VoteFinding;
+export declare function getVoteFindingEncoder(): Encoder<VoteFindingArgs>;
+export declare function getVoteFindingDecoder(): Decoder<VoteFinding>;
+export declare function getVoteFindingCodec(): Codec<VoteFindingArgs, VoteFinding>;

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './generated';
+export * from './manifest';
+export * from './proposal';

package/dist/types/manifest.d.ts

@@ -0,0 +1,72 @@
+import { type Codec, type Decoder, type Encoder, type ReadonlyUint8Array } from '@solana/kit';
+/** An off-chain file and the sha256 its bytes must match. */
+export type Artifact = {
+    /** Where to fetch the file. */
+    uri: string;
+    /** sha256 the fetched bytes must match, 32 bytes. */
+    sha256: ReadonlyUint8Array;
+};
+/**
+ * The release manifest a publisher uploads with `write_release_manifest` and guardians vote on.
+ * `__kind` is the schema version. The encoding is specified in `docs/manifest.md`. Different from
+ * `ReleaseManifest`, the program's account record of a proposed release, its manifest bytes, and
+ * its votes.
+ */
+export type Manifest = {
+    __kind: 'V1';
+} & ManifestV1;
+/** Schema version 1 of a {@link Manifest}. */
+export type ManifestV1 = {
+    /** Android `versionCode`. Must equal the release's on-chain `version_code`. */
+    versionCode: number;
+    /** Android package name, e.g. `com.example.app`. */
+    package: string;
+    /** Android `versionName`. */
+    versionName: string;
+    /** Android `minSdkVersion`. */
+    minSdk: number;
+    /** Android permissions the APK requests. */
+    permissions: string[];
+    /** The APK. */
+    apk: Artifact;
+    /** URL of the terms and conditions. */
+    terms: string;
+    /** URL of the privacy policy. */
+    privacy: string;
+    /** sha256 of the APK's signing certificate, 32 bytes. Must equal the release's on-chain `certificate_sha256`. */
+    certificateSha256: ReadonlyUint8Array;
+    /** The publisher's website URL, or `null`. */
+    publisherSite: string | null;
+};
+/**
+ * Manifest bytes per `write_release_manifest` transaction, leaving headroom in a 1232-byte legacy
+ * transaction with two signers.
+ */
+export declare const DEFAULT_MANIFEST_CHUNK = 800;
+/** One `write_release_manifest` upload: `bytes` go at byte `offset` of the encoded manifest. */
+export type ManifestChunk = {
+    offset: number;
+    bytes: ReadonlyUint8Array;
+};
+/**
+ * Splits an encoded manifest into upload chunks of at most `chunkSize` bytes, in order, each with
+ * its byte offset. An empty manifest gives one empty chunk, so a write still starts its release.
+ * Throws if `chunkSize` is not a positive integer.
+ */
+export declare function getManifestChunks(manifest: ReadonlyUint8Array, chunkSize?: number): ManifestChunk[];
+/**
+ * The sha256 of an encoded manifest, which `propose_release` takes as `manifestHash`. Finalizing
+ * fails with `ManifestHashMismatch` unless the uploaded bytes hash to it.
+ */
+export declare function getManifestHash(manifest: ReadonlyUint8Array): Promise<Uint8Array>;
+/** Encodes a {@link Manifest}. See {@link getManifestCodec}. */
+export declare function getManifestEncoder(): Encoder<Manifest>;
+/** Decodes a {@link Manifest}. See {@link getManifestCodec}. */
+export declare function getManifestDecoder(): Decoder<Manifest>;
+/**
+ * The borsh encoding of a {@link Manifest}, the bytes `write_release_manifest` uploads and the
+ * on-chain manifest hash covers. Like the Rust decoder in `tools/manifest`, decoding throws on an
+ * unknown schema version, an option tag other than 0 or 1, invalid UTF-8, a truncated field, or
+ * trailing bytes, so each manifest has one encoding.
+ */
+export declare function getManifestCodec(): Codec<Manifest>;

package/dist/types/proposal.d.ts

@@ -0,0 +1,66 @@
+import type { ReadonlyUint8Array } from '@solana/kit';
+import type { AppAccount, GuardiansConfig, ReleaseManifest } from './generated';
+/** The release in `app`'s pending slot, or `null` when the slot is empty. */
+export declare function getPendingRelease(app: Pick<AppAccount, 'pendingRelease'>): ReleaseManifest | null;
+/** A resolved release that still takes late votes, which holds the app's next release. */
+export type LateVoteWindow = {
+    /** Cluster unix time, in seconds, at which the window closes. */
+    closesAt: bigint;
+    /** Votes cast so far, including late ones. */
+    votesCast: number;
+    /** Guardians in the set the release resolved under. */
+    guardians: number;
+};
+/**
+ * The late-vote window `pending` is in at cluster time `now` (unix seconds), or `null` when it
+ * takes no more late votes. While it is open, the program refuses the app's next
+ * `write_release_manifest` and `propose_release` with `VoteWindowOpen`. A window is open while
+ * `now` is before `quorumTs + config.voteWindow`, the guardian set hasn't changed since the
+ * release's round, and some guardian hasn't voted.
+ */
+export declare function getLateVoteWindow(pending: ReleaseManifest | null, config: Pick<GuardiansConfig, 'guardians' | 'updateNonce' | 'voteWindow'>, now: bigint): LateVoteWindow | null;
+/** What proposing a version takes next, per {@link getReleaseProposalStep}. */
+export type ReleaseProposalStep = 
+/**
+ * Write the manifest, then propose it. `written` is the buffer an unfinished upload of the same
+ * version and length left, which the writes may build on; `null` when the upload starts fresh.
+ */
+{
+    kind: 'write';
+    written: ReadonlyUint8Array | null;
+}
+/**
+ * Cancel the release in the slot first: an older version's unresolved round or unfinished
+ * upload, or an unfinished upload of this version with another length. Only the app authority
+ * may cancel.
+ */
+ | {
+    kind: 'cancelFirst';
+}
+/** The version is at or below the app's last resolved version, so it can't be proposed. */
+ | {
+    kind: 'spent';
+}
+/**
+ * The version is already proposed, or a newer version holds the slot, as a round or an
+ * unfinished upload. The app authority could cancel the newer one, but a proposal never
+ * displaces a newer version.
+ */
+ | {
+    kind: 'underReview';
+    pendingVersionCode: number;
+}
+/** The last release still takes late votes; propose after the window closes. */
+ | {
+    kind: 'waitForLateVotes';
+    window: LateVoteWindow;
+};
+/**
+ * What proposing `versionCode`, with a manifest of `manifestLength` bytes, takes next under `app`
+ * (`null` before it is registered). `clock` (the guardian config and cluster time) decides
+ * whether a resolved release still holds the slot, and is needed only when the app has one.
+ */
+export declare function getReleaseProposalStep(app: Pick<AppAccount, 'lastResolvedVersion' | 'pendingRelease'> | null, versionCode: number, manifestLength: number, clock: {
+    config: Pick<GuardiansConfig, 'guardians' | 'updateNonce' | 'voteWindow'>;
+    now: bigint;
+} | null): ReleaseProposalStep;

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@solana-mobile/guardian-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "JavaScript client for the guardian program",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/solana-mobile/guardian-system.git",
+    "directory": "clients/js"
+  },
+  "files": [
+    "./dist/src",
+    "./dist/types"
+  ],
+  "type": "commonjs",
+  "sideEffects": false,
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/src/index.mjs",
+      "require": "./dist/src/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@solana/program-client-core": "^8.5.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "3.0.3",
+    "@solana-config/oxc": "^0.1.1",
+    "@solana/kit": "^8.5.0",
+    "@types/node": "^24",
+    "oxfmt": "^0.55.0",
+    "oxlint": "^1.70.0",
+    "oxlint-tsgolint": "^0.23.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.1.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15"
+  },
+  "peerDependencies": {
+    "@solana/kit": "^8.5.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
+    "dev": "vitest",
+    "test": "vitest run",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "format": "oxfmt --check",
+    "format:fix": "oxfmt",
+    "changeset:check": "node ./scripts/check-changesets.mjs",
+    "publish-packages": "pnpm build && pnpm changeset publish"
+  }
 }