@aephia/atlas-kit 0.6.0-next.2 → 0.6.0-next.20

package/dist/cargo/actions/withdrawal.js

@@ -0,0 +1,269 @@
+import { AccountRole, getAddressEncoder, getProgramDerivedAddress, isOffCurveAddress, } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { sage } from '../../internal/c4/bindings.js';
+import { characterAccountDefinition, profileAccountDefinition, findCharacterPda, } from '../../internal/c4/identity.js';
+import { deriveStarbasePlayerAddress, starbasePlayerAccountDefinition, } from '../../internal/c4/starbase.js';
+import { starSystemAccountDefinition, deriveStarSystemAddress, } from '../../internal/c4/world.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { adaptWithdrawCargoFromGameInstruction, validatePlanAuthorization, } from '../../internal/planning/authorization-adapter.js';
+import { createPlan, } from '../../planning/index.js';
+import { readFreshGameCargoConfiguration } from '../../registry/cargo.js';
+import { deriveWalletTokenAddress, failWalletCargo, validateWalletMint, validateWalletToken, ORIGINAL_TOKEN_PROGRAM, } from './wallet-token.js';
+import { observeWalletAccount, validateWalletCargoCache, } from './wallet-context.js';
+const ATA_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+const SYSTEM_PROGRAM = '11111111111111111111111111111111';
+const RENT_SYSVAR = 'SysvarRent111111111111111111111111111111111';
+const SYSVAR_OWNER = 'Sysvar1111111111111111111111111111111111111';
+function required(account, address) {
+    if (!account)
+        failWalletCargo(`Required withdrawal account ${address} is missing. Register the player or initialize its prerequisites separately.`, address);
+    return account;
+}
+/** Plans an exact game-to-wallet withdrawal without signing or submitting.
+ * Current verified game/token conversion is limited to zero-decimal cargo mints.
+ * The recipient never signs merely to receive tokens. ATA creation is explicit,
+ * with storage funding described separately from execution transaction fees.
+ * Permissions and the remaining epoch budget stay chain-authoritative.
+ * @example
+ * ```ts
+ * import {planWithdrawCargoFromGame} from '@aephia/atlas-kit/cargo/actions';
+ * import type {SageContext,Address} from '@aephia/atlas-kit/client';
+ * import type {StarbasePlayerSnapshot} from '@aephia/atlas-kit/starbases';
+ * declare const ctx:SageContext;
+ * declare const starbase:StarbasePlayerSnapshot;
+ * declare const authorization:PlanAuthorization;
+ * declare const recipient:Address;
+ * const plan=await planWithdrawCargoFromGame(ctx,starbase,{cargoId:3,amount:10n,authorization,recipient});
+ * console.log(plan.summary);
+ * ```
+ */
+export async function planWithdrawCargoFromGame(ctx, starbase, options) {
+    validatePlanAuthorization(options.authorization);
+    if (typeof options.amount !== 'bigint' ||
+        options.amount <= 0n ||
+        options.amount > 18446744073709551615n)
+        throw new InvalidActionInputError('amount', options.amount, 'a positive bigint in the unsigned u64 range', 'Supply an exact raw token amount as bigint.');
+    if (!Number.isSafeInteger(options.cargoId) ||
+        options.cargoId < 0 ||
+        options.cargoId > 65535)
+        throw new InvalidActionInputError('cargoId', options.cargoId, 'an unsigned u16 cargo ID', 'Choose an existing cargo definition ID.');
+    const creation = options.destinationAccount;
+    if (creation && (creation.mode !== 'create-if-missing' || !creation.payer))
+        throw new InvalidActionInputError('destinationAccount', creation, 'create-if-missing with an explicit payer', 'Provide an address-only payer to opt into canonical ATA creation.');
+    const game = requireGameAddress(ctx);
+    const character = await findCharacterPda(options.authorization.profile, game);
+    const player = await deriveStarbasePlayerAddress(starbase.system.address, character);
+    if (starbase.kind !== 'starbasePlayer' ||
+        starbase.address !== player ||
+        starbase.playerProfile.address !== options.authorization.profile ||
+        starbase.character.address !== character)
+        failWalletCargo('The loaded Starbase must belong to the authorized Profile and its canonical Character.', starbase.address);
+    const config = await readFreshGameCargoConfiguration(ctx, options.cargoId);
+    const [cache, bump] = await getProgramDerivedAddress({
+        programAddress: sage.SAGE_PROGRAM_ADDRESS,
+        seeds: [
+            new TextEncoder().encode('CargoDefinitionsCache'),
+            getAddressEncoder().encode(game),
+        ],
+    });
+    if (config.cache !== cache)
+        failWalletCargo('The configured cargo cache differs from the canonical Game cache.', config.cache);
+    const canonicalDestination = await deriveWalletTokenAddress(options.recipient, config.cargo.mint);
+    const destination = options.destination ?? canonicalDestination;
+    const source = await deriveWalletTokenAddress(cache, config.cargo.mint);
+    if (destination === source)
+        failWalletCargo('The withdrawal destination is the shared Game vault itself. Choose a different recipient token account so the withdrawal actually transfers tokens out of the vault.', destination);
+    const addresses = [
+        options.authorization.profile,
+        character,
+        player,
+        starbase.system.address,
+        cache,
+        config.cargo.mint,
+        source,
+    ];
+    const candidates = await readContextRawAccounts(ctx, [
+        ...addresses,
+        destination,
+        options.recipient,
+    ]);
+    const accounts = addresses.map((address, index) => required(candidates[index], address));
+    const [profileRaw, characterRaw, playerRaw, systemRaw, cacheRaw, mintRaw, vaultRaw,] = accounts;
+    const destinationRaw = candidates[addresses.length];
+    const recipientRaw = candidates[addresses.length + 1];
+    profileAccountDefinition.decode(profileRaw);
+    const characterData = characterAccountDefinition.decode(characterRaw);
+    const playerData = starbasePlayerAccountDefinition.decode(playerRaw);
+    const systemData = starSystemAccountDefinition.decode(systemRaw);
+    if (characterData.game !== game ||
+        characterData.playerProfile !== options.authorization.profile ||
+        playerData.playerProfile !== options.authorization.profile ||
+        playerData.character !== character ||
+        playerData.system !== starbase.system.address ||
+        systemData.game !== game ||
+        (await deriveStarSystemAddress(game, systemData.systemId)) !==
+            starbase.system.address)
+        failWalletCargo('Fresh Profile, Character, System and player Starbase relationships do not match the configured Game.', player);
+    const cacheData = validateWalletCargoCache(cacheRaw, game, bump);
+    const decimals = validateWalletMint(mintRaw);
+    if (decimals !== 0)
+        failWalletCargo('Withdrawal game/token conversion for nonzero-decimal cargo mints is not verified. Use supported zero-decimal cargo until a bindings/program review establishes conversion.', config.cargo.mint);
+    const backing = validateWalletToken(vaultRaw, config.cargo.mint, cache);
+    if (destinationRaw)
+        validateWalletToken(destinationRaw, config.cargo.mint, options.recipient);
+    if (recipientRaw &&
+        recipientRaw.data.length === 355 &&
+        (recipientRaw.owner === ORIGINAL_TOKEN_PROGRAM ||
+            recipientRaw.owner ===
+                'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'))
+        failWalletCargo('Token multisig recipients are outside the supported wallet cargo contract.', options.recipient);
+    const entitlement = playerData.cargo.amounts.find((item) => item.cargoId === options.cargoId)
+        ?.amount ?? 0n;
+    if (entitlement < options.amount)
+        failWalletCargo(`Player Starbase cargo entitlement ${String(entitlement)} is below requested ${String(options.amount)}. Shared vault backing is not personal inventory. Reduce the amount.`, player);
+    if (backing < options.amount)
+        failWalletCargo(`Shared Game vault backing ${String(backing)} is below requested ${String(options.amount)}. Retry after backing is restored.`, source);
+    if (config.cargo.withdrawEpochDuration === 0)
+        failWalletCargo('Withdrawal of this cargo is disabled by the Game configuration.', game);
+    if (options.amount > config.cargo.circuitBreaker)
+        failWalletCargo(`Requested amount exceeds the configured per-epoch withdrawal cap ${String(config.cargo.circuitBreaker)}. Reduce the amount.`, cache);
+    const preconditions = await Promise.all([
+        [profileRaw, 'Profile authorization'],
+        [characterRaw, 'Character identity'],
+        [playerRaw, 'personal Starbase inventory'],
+        [systemRaw, 'System access configuration'],
+        ...(recipientRaw ? [[recipientRaw, 'wallet authority']] : []),
+    ].map(([account, role]) => observeWalletAccount(account, role)));
+    preconditions.push({
+        kind: 'token-mint',
+        address: mintRaw.address,
+        decimals,
+        describes: `Mint ${mintRaw.address} remains a valid initialized original Token Mint with unchanged decimals; supply and authorities may change.`,
+    }, {
+        kind: 'game-cargo-config',
+        address: game,
+        cargoId: options.cargoId,
+        configHash: config.configHash,
+        describes: 'The selected cargo configuration and cache identity remain unchanged; unrelated Game changes are allowed.',
+    }, {
+        kind: 'cargo-cache',
+        address: cache,
+        game,
+        bump,
+        describes: 'The canonical cargo cache retains valid Game identity and layout; counters may change.',
+    }, {
+        kind: 'token-account',
+        address: source,
+        mint: config.cargo.mint,
+        owner: cache,
+        minimumBalance: options.amount,
+        describes: 'The existing shared vault remains a valid original Token account with sufficient raw tokens.',
+    }, ...(destinationRaw
+        ? [
+            {
+                kind: 'token-account',
+                address: destination,
+                mint: config.cargo.mint,
+                owner: options.recipient,
+                minimumBalance: 0n,
+                describes: 'The existing destination remains a valid original Token account; incoming tokens are allowed.',
+            },
+        ]
+        : []));
+    if (!recipientRaw)
+        preconditions.push({
+            kind: 'system-account-or-absent',
+            address: options.recipient,
+            describes: 'The recipient wallet may remain absent or receive native funding as an empty, non-executable System account.',
+        });
+    const steps = [];
+    if (!destinationRaw) {
+        if (!creation || destination !== canonicalDestination)
+            failWalletCargo('The destination token account is missing. Create custom accounts separately or explicitly opt into canonical ATA creation with a payer.', destination);
+        if (isOffCurveAddress(creation.payer))
+            failWalletCargo('ATA creation payer must be a directly signing address.', creation.payer);
+        const extraAddresses = [
+            RENT_SYSVAR,
+            creation.payer,
+            ATA_PROGRAM,
+            SYSTEM_PROGRAM,
+            ORIGINAL_TOKEN_PROGRAM,
+        ];
+        const extraCandidates = await readContextRawAccounts(ctx, extraAddresses);
+        const extra = extraAddresses.map((address, index) => required(extraCandidates[index], address));
+        const [rent, payer, ...programs] = extra;
+        if (programs.some((program) => !program.executable))
+            failWalletCargo('Associated-token creation requires executable associated-token, System and original Token programs in this deployment.', ATA_PROGRAM);
+        if (rent.owner !== SYSVAR_OWNER ||
+            rent.executable ||
+            rent.data.length !== 17)
+            failWalletCargo('The deployment Rent sysvar has an unsupported owner or layout. Verify storage funding before creating an ATA.', RENT_SYSVAR);
+        const rentView = new DataView(rent.data.buffer, rent.data.byteOffset, rent.data.byteLength);
+        const rate = rentView.getBigUint64(0, true);
+        const threshold = rentView.getFloat64(8, true);
+        const rawCost = Number(rate * 293n) * threshold;
+        if (!Number.isFinite(rawCost) ||
+            rawCost < 0 ||
+            !Number.isSafeInteger(Math.floor(rawCost)))
+            failWalletCargo('ATA rent exemption cannot be represented exactly for this deployment.', RENT_SYSVAR);
+        const storageFunding = BigInt(Math.floor(rawCost));
+        if (payer.owner !== SYSTEM_PROGRAM ||
+            payer.executable ||
+            payer.data.length !== 0 ||
+            payer.lamports < storageFunding)
+            failWalletCargo(`ATA payer must be a System wallet with at least ${String(storageFunding)} lamports for storage, in addition to transaction fees.`, creation.payer);
+        preconditions.push(...(await Promise.all(extra.map((account, index) => observeWalletAccount(account, [
+            'Rent configuration',
+            'ATA payer identity',
+            'associated-token program',
+            'System program',
+            'Token program',
+        ][index])))), {
+            kind: 'token-account-or-absent',
+            address: destination,
+            mint: config.cargo.mint,
+            owner: options.recipient,
+            describes: 'The canonical recipient ATA is absent or a valid initialized unfrozen original Token account for this exact mint and recipient.',
+        });
+        steps.push({
+            describes: `Create the canonical recipient ATA ${destination} idempotently. Payer ${creation.payer} funds ${String(storageFunding)} lamports of rent-exempt storage if still absent; this is separate from transaction fees.`,
+            signers: [creation.payer],
+            instruction: {
+                programAddress: ATA_PROGRAM,
+                accounts: [
+                    { address: creation.payer, role: AccountRole.WRITABLE_SIGNER },
+                    { address: destination, role: AccountRole.WRITABLE },
+                    { address: options.recipient, role: AccountRole.READONLY },
+                    { address: config.cargo.mint, role: AccountRole.READONLY },
+                    { address: SYSTEM_PROGRAM, role: AccountRole.READONLY },
+                    { address: ORIGINAL_TOKEN_PROGRAM, role: AccountRole.READONLY },
+                ],
+                data: new Uint8Array([1]),
+            },
+        });
+    }
+    const epoch = cacheData.cargoTypeCache.get(options.cargoId);
+    const describes = `Withdraw ${String(options.amount)} raw token units of cargo ${String(options.cargoId)} from shared Game vault ${source} to ${destination}, owned by explicit recipient ${options.recipient}; debit the same verified zero-decimal quantity from player Starbase ${player}. Profile authority ${options.authorization.authority} signs; receiving does not require a recipient signature. Epoch duration ${String(config.cargo.withdrawEpochDuration)}, cap ${String(config.cargo.circuitBreaker)}; ${epoch ? `observed cache epoch ${String(epoch.currentEpoch)}, total withdrawn ${String(epoch.totalWithdrawn)}` : 'no retained cargo epoch entry'}. No remaining-epoch budget is predicted. Permissions, rollover, competing withdrawals and final balances remain chain-authoritative; simulate before signing. Transaction fees are paid separately by the execution fee payer. Mint supply and authorities may change; initialized original Token mint layout and decimals are rechecked before signing.${recipientRaw ? '' : ' An absent recipient wallet may receive native funding as an empty, non-executable System account.'}`;
+    steps.push({
+        describes,
+        signers: [options.authorization.authority],
+        instruction: adaptWithdrawCargoFromGameInstruction({
+            authorization: options.authorization,
+            systemAndStarbasePlayerSystem: starbase.system.address,
+            systemAndStarbasePlayerStarbasePlayer: player,
+            game,
+            cargoCache: cache,
+            source,
+            destination,
+            amount: options.amount,
+        }),
+    });
+    return createPlan({
+        kind: 'cargo.wallet-withdrawal',
+        summary: describes,
+        preconditions,
+        steps,
+    });
+}
+//# sourceMappingURL=withdrawal.js.map

package/dist/cargo/actions/withdrawal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal.js","sourceRoot":"","sources":["../../../src/cargo/actions/withdrawal.ts"],"names":[],"mappings":"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"}

package/dist/client/errors.d.ts

@@ -185,6 +185,10 @@ export declare class InvalidDerivationInputError extends SageSdkError {
     constructor(field: string, value: number | bigint, remedy?: string);
 }
 /** Error thrown when a write-side input is invalid before planning or RPC work.
+ *
+ * Object values use bounded field-name previews and arrays use their length;
+ * nested values and custom serialization are not evaluated. The original input
+ * remains available on `value`.
  *
  * @example
  * ```ts

package/dist/client/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"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"}

package/dist/client/errors.js

@@ -213,7 +213,37 @@ export class InvalidDerivationInputError extends SageSdkError {
         this.value = value;
     }
 }
+// Describe shape without traversing values or invoking caller serialization.
+function describeActionInput(value) {
+    if (typeof value === 'function')
+        return 'a function';
+    if (value === null || typeof value !== 'object')
+        return String(value);
+    try {
+        if (Array.isArray(value)) {
+            const length = Object.getOwnPropertyDescriptor(value, 'length').value;
+            return typeof length === 'number'
+                ? `an array of length ${length}`
+                : 'an array';
+        }
+        const keys = Object.keys(value);
+        if (keys.length === 0)
+            return 'an object with no enumerable fields';
+        const preview = keys
+            .slice(0, 5)
+            .map((key) => JSON.stringify(key.length > 40 ? `${key.slice(0, 40)}…` : key))
+            .join(', ');
+        return `an object with fields ${preview}${keys.length > 5 ? ', …' : ''}`;
+    }
+    catch {
+        return 'an object whose shape could not be inspected';
+    }
+}
 /** Error thrown when a write-side input is invalid before planning or RPC work.
+ *
+ * Object values use bounded field-name previews and arrays use their length;
+ * nested values and custom serialization are not evaluated. The original input
+ * remains available on `value`.
  *
  * @example
  * ```ts
@@ -229,7 +259,7 @@ export class InvalidActionInputError extends SageSdkError {
     field;
     value;
     constructor(field, value, acceptedRange, remedy) {
-        super('INVALID_ACTION_INPUT', `${field} is ${String(value)}, which is invalid. Use ${acceptedRange}. ${remedy}`);
+        super('INVALID_ACTION_INPUT', `${field} is ${describeActionInput(value)}, which is invalid. Use ${acceptedRange}. ${remedy}`);
         this.field = field;
         this.value = value;
     }

package/dist/client/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -5,4 +5,5 @@ export { readMeta, type DefinitionPreloadMeta, type PreloadedDefinitions, type I
 export { entityRef, type EntityRef } from './refs.js';
 export type { CargoDefinitionSummary, DefinitionLookupOptions, DefinitionSection, DefinitionSectionSnapshot, RegistrySnapshotStore, ShipDefinitionSummary, } from '../registry/index.js';
 export { InvalidDefinitionSectionError } from './errors.js';
+export { createRpcSubscriptionProvider, type RpcSubscriptionProviderOptions, } from './rpc-subscription-provider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,gCAAgC,CAAC"}

package/dist/client/index.js

@@ -3,4 +3,5 @@ export { AccountDecodeError, AccountNotFoundError, ContextDisposedError, Invalid
 export { readMeta, } from '../internal/read-meta.js';
 export { entityRef } from './refs.js';
 export { InvalidDefinitionSectionError } from './errors.js';
+export { createRpcSubscriptionProvider, } from './rpc-subscription-provider.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,GAOT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAUtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,GAOT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AAUtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,6BAA6B,GAE9B,MAAM,gCAAgC,CAAC"}

package/dist/client/rpc-subscription-provider.d.ts

@@ -0,0 +1,35 @@
+import { type AccountNotificationsApi, type RpcSubscriptions } from '@solana/kit';
+import type { AccountSubscriptionProvider, DataSourceIdentity } from './contracts.js';
+/** Options for the injected Kit WebSocket account adapter. No connection is opened by the factory.
+ *
+ * @example
+ * ```ts
+ * import type { AccountNotificationsApi, RpcSubscriptions } from '@solana/kit';
+ * declare const rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+ * const options: RpcSubscriptionProviderOptions = { rpcSubscriptions };
+ * ```
+ */
+export interface RpcSubscriptionProviderOptions {
+    readonly rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+    /** Non-secret provenance label; never supply an endpoint or credentials. */
+    readonly identity?: DataSourceIdentity;
+    readonly backoff?: {
+        readonly initialMs?: number;
+        readonly maxMs?: number;
+    };
+}
+/** Adapt an application-owned Kit transport to context-owned account subscriptions.
+ * Initial registration failures reject with a sanitized ProviderError. Dropped
+ * streams retry with equal jitter (half to all of the capped exponential delay).
+ * Successful registration resets backoff. Cancellation releases Kit through its
+ * abort signal; iterator cleanup is best-effort and cannot block unsubscribe.
+ *
+ * @example
+ * ```ts
+ * import type { AccountNotificationsApi, RpcSubscriptions } from '@solana/kit';
+ * declare const rpcSubscriptions: RpcSubscriptions<AccountNotificationsApi>;
+ * const subscriptions = createRpcSubscriptionProvider({ rpcSubscriptions });
+ * ```
+ */
+export declare function createRpcSubscriptionProvider(options: RpcSubscriptionProviderOptions): AccountSubscriptionProvider;
+//# sourceMappingURL=rpc-subscription-provider.d.ts.map

package/dist/client/rpc-subscription-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-subscription-provider.d.ts","sourceRoot":"","sources":["../../src/client/rpc-subscription-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IACrE,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,2BAA2B,CAiI7B"}