@black-market/sdk 0.1.0 → 0.4.0

package/src/lifecycle/abi.ts

@@ -0,0 +1,343 @@
+import {
+  adapterRegistrationV1Components, launchExecutionContextV1Components, launchPlanV1Components, launchProgressV1Components,
+  launchReceiptV1Components, lifecycleFeePolicyComponents, lifecycleMarketComponents, marketIdentityV1Components,
+  marketLiveStateV1Components, positionIdentityV1Components, preparedMarketV1Components,
+  profileRegistrationV1Components, profileTopologyV1Components, launchEnvelopeV2Components, sourceTermsV3Components,
+} from "./schema.js";
+import { poolBoundHookParametersV1Components, v4LifecycleMarketComponents } from "./markets.js";
+
+const planInput = { name: "plan", type: "tuple", components: launchPlanV1Components } as const;
+export const launchLifecycleAbi = [
+  { type: "function", name: "hashPlan", stateMutability: "pure", inputs: [planInput], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "launchIdOf", stateMutability: "pure", inputs: [planInput], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "predictToken", stateMutability: "view", inputs: [planInput], outputs: [{ type: "address" }] },
+  { type: "function", name: "launchAtomic", stateMutability: "payable", inputs: [planInput], outputs: [{ type: "tuple", components: launchReceiptV1Components }] },
+  { type: "function", name: "beginLaunch", stateMutability: "payable", inputs: [planInput, { name: "mode", type: "uint8" }], outputs: [{ type: "tuple", components: launchProgressV1Components }] },
+  { type: "function", name: "prepareMarkets", stateMutability: "nonpayable", inputs: [planInput, { name: "firstMarket", type: "uint32" }, { name: "count", type: "uint32" }], outputs: [] },
+  { type: "function", name: "activateLaunch", stateMutability: "nonpayable", inputs: [planInput], outputs: [{ type: "tuple", components: launchReceiptV1Components }] },
+  { type: "function", name: "cancelLaunch", stateMutability: "nonpayable", inputs: [planInput], outputs: [] },
+  { type: "function", name: "readLaunchProgress", stateMutability: "view", inputs: [{ name: "launchId", type: "bytes32" }], outputs: [{ type: "tuple", components: launchProgressV1Components }] },
+  { type: "function", name: "executionContext", stateMutability: "view", inputs: [], outputs: [{ type: "tuple", components: launchExecutionContextV1Components }] },
+  { type: "function", name: "authorizeTokenTransfer", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }, { type: "address" }, { type: "address" }, { type: "uint256" }, { type: "bool" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "isLaunchActive", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "escrowBalance", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "registry", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "directory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "tokenFactory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "fundingEscrow", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "feeFactory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "event", name: "LaunchBegun", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "planHash", type: "bytes32", indexed: true },
+    { name: "creator", type: "address", indexed: true }, { name: "token", type: "address", indexed: false },
+    { name: "feeHub", type: "address", indexed: false }, { name: "rewards", type: "address", indexed: false }, { name: "mode", type: "uint8", indexed: false },
+  ] },
+  { type: "event", name: "MarketPrepared", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "marketIndex", type: "uint32", indexed: true },
+    { name: "canonicalId", type: "bytes32", indexed: true }, { name: "adapter", type: "address", indexed: false },
+    { name: "feeSource", type: "address", indexed: false }, { name: "positionCount", type: "uint32", indexed: false },
+  ] },
+  { type: "event", name: "LaunchReady", anonymous: false, inputs: [{ name: "launchId", type: "bytes32", indexed: true }] },
+  { type: "event", name: "InitialBuyExecuted", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "buyIndex", type: "uint32", indexed: true },
+    { name: "marketIndex", type: "uint32", indexed: true }, { name: "quoteAsset", type: "address", indexed: false },
+    { name: "quoteSpent", type: "uint256", indexed: false }, { name: "tokenOut", type: "uint256", indexed: false }, { name: "recipient", type: "address", indexed: false },
+  ] },
+  { type: "event", name: "LaunchActivated", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "planHash", type: "bytes32", indexed: true },
+    { name: "token", type: "address", indexed: true }, { name: "marketCount", type: "uint32", indexed: false }, { name: "positionCount", type: "uint32", indexed: false },
+  ] },
+  { type: "event", name: "LaunchCancelled", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "creator", type: "address", indexed: true }, { name: "inventoryBurned", type: "bool", indexed: false },
+  ] },
+  { type: "event", name: "AssetRefunded", anonymous: false, inputs: [
+    { name: "launchId", type: "bytes32", indexed: true }, { name: "asset", type: "address", indexed: true },
+    { name: "creator", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false },
+  ] },
+] as const;
+export const lifecycleRegistryAbi = [
+  { type: "function", name: "core", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "adapter", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: adapterRegistrationV1Components }] },
+  { type: "function", name: "profile", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: profileRegistrationV1Components }] },
+  { type: "function", name: "profileTopology", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: profileTopologyV1Components }] },
+  { type: "function", name: "requireEligible", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "bytes32" }, { type: "uint32" }, { type: "uint64" }], outputs: [{ type: "address" }] },
+  { type: "function", name: "fundingInputAllowed", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "fundingTarget", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ name: "spender", type: "address" }, { name: "codeHash", type: "bytes32" }, { name: "enabled", type: "bool" }] },
+  { type: "function", name: "adapterCount", stateMutability: "view", inputs: [], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "profileCount", stateMutability: "view", inputs: [], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "adapterIds", stateMutability: "view", inputs: [{ type: "uint256" }, { type: "uint256" }], outputs: [{ type: "bytes32[]" }] },
+  { type: "function", name: "profileIds", stateMutability: "view", inputs: [{ type: "uint256" }, { type: "uint256" }], outputs: [{ type: "bytes32[]" }] },
+  { type: "function", name: "admin", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "protocolMaximumDeveloperFeeBps", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "profileEnvelope", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: launchEnvelopeV2Components }] },
+  { type: "function", name: "profileId", stateMutability: "pure", inputs: [{ type: "tuple", components: launchEnvelopeV2Components }], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "developerTerms", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [
+    { name: "adapter", type: "address" }, { name: "beneficiary", type: "address" },
+    { name: "maximumDeveloperFeeBps", type: "uint16" }, { name: "termsDigest", type: "bytes32" }, { name: "enabled", type: "bool" },
+  ] },
+  { type: "function", name: "beneficiaryNonces", stateMutability: "view", inputs: [{ name: "authorId", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "authorizationDigest", stateMutability: "view", inputs: [
+    { name: "profileId", type: "bytes32" }, { name: "registration", type: "tuple", components: profileRegistrationV1Components },
+    { name: "envelope", type: "tuple", components: launchEnvelopeV2Components },
+    { name: "nonce", type: "uint256" }, { name: "deadline", type: "uint256" },
+  ], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "registerProfile", stateMutability: "nonpayable", inputs: [
+    { name: "profileId", type: "bytes32" }, { name: "registration", type: "tuple", components: profileRegistrationV1Components },
+    { name: "envelope", type: "tuple", components: launchEnvelopeV2Components },
+    { name: "nonce", type: "uint256" }, { name: "deadline", type: "uint256" }, { name: "authorization", type: "bytes" },
+  ], outputs: [] },
+  { type: "function", name: "registerAbyssProfile", stateMutability: "nonpayable", inputs: [
+    { name: "variant", type: "uint8" },
+    { name: "registration", type: "tuple", components: profileRegistrationV1Components },
+  ], outputs: [] },
+  { type: "function", name: "authorPayout", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "address" }] },
+  { type: "function", name: "setAuthorPayout", stateMutability: "nonpayable", inputs: [{ name: "authorId", type: "address" }, { name: "payout", type: "address" }], outputs: [] },
+  { type: "function", name: "authorHubCount", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "authorHubs", stateMutability: "view", inputs: [{ type: "address" }, { type: "uint256" }, { type: "uint256" }], outputs: [
+    { name: "hubs", type: "address[]" }, { name: "nextOffset", type: "uint256" }, { name: "total", type: "uint256" },
+  ] },
+  { type: "event", name: "AuthorPayoutUpdated", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "previousPayout", type: "address", indexed: true },
+    { name: "newPayout", type: "address", indexed: true }, { name: "operator", type: "address", indexed: false },
+  ] },
+  { type: "event", name: "AuthorHubRegistered", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "hub", type: "address", indexed: true }, { name: "index", type: "uint256", indexed: false },
+  ] },
+] as const;
+export const lifecycleAdapterAbi = [
+  { type: "function", name: "core", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "dependencyDigest", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "resolve", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "address" }, { type: "tuple", components: lifecycleMarketComponents }], outputs: [{ type: "tuple", components: marketIdentityV1Components }] },
+  { type: "function", name: "validatePrepared", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "uint32" }, { type: "address" }, { type: "tuple", components: lifecycleMarketComponents }, { type: "tuple", components: marketIdentityV1Components }], outputs: [] },
+  { type: "function", name: "readMarket", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "uint32" }], outputs: [{ type: "tuple", components: marketLiveStateV1Components }] },
+  { type: "function", name: "readPosition", stateMutability: "view", inputs: [{ type: "tuple", components: positionIdentityV1Components }], outputs: [{ type: "uint128" }, { type: "address" }] },
+] as const;
+
+const v4AdapterMetadataAbi = [
+  ...lifecycleAdapterAbi,
+  { type: "function", name: "PROFILE_ID", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "CONFIG_SCHEMA", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "CONFIG_VERSION", stateMutability: "view", inputs: [], outputs: [{ type: "uint32" }] },
+  { type: "function", name: "implementationRegistry", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "poolManager", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "hookRoot", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "oracleFactory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "locker", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "collectorFactory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "hookDeployer", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+] as const;
+export const sharedMarketAdapterV1Abi = [
+  ...v4AdapterMetadataAbi,
+  { type: "constructor", stateMutability: "nonpayable", inputs: [
+    { name: "core_", type: "address" }, { name: "manager_", type: "address" }, { name: "root_", type: "address" },
+    { name: "locker_", type: "address" }, { name: "helper_", type: "address" }, { name: "registry_", type: "address" },
+    { name: "deployer_", type: "address" }, { name: "profileId_", type: "bytes32" },
+  ] },
+] as const;
+export const abyssLifecycleAdapterAbi = [
+  ...lifecycleAdapterAbi,
+  { type: "function", name: "CONFIG_SCHEMA", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "CONFIG_VERSION", stateMutability: "view", inputs: [], outputs: [{ type: "uint32" }] },
+  { type: "function", name: "profileId", stateMutability: "view", inputs: [{ type: "uint8" }], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "factory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+] as const;
+export const poolMarketAdapterV1Abi = [
+  ...v4AdapterMetadataAbi,
+  { type: "constructor", stateMutability: "nonpayable", inputs: [
+    { name: "core_", type: "address" }, { name: "manager_", type: "address" }, { name: "oracleFactory_", type: "address" },
+    { name: "locker_", type: "address" }, { name: "deployer_", type: "address" }, { name: "helper_", type: "address" },
+    { name: "registry_", type: "address" }, { name: "profileId_", type: "bytes32" },
+  ] },
+  { type: "function", name: "hookDeploymentMetadata", stateMutability: "view", inputs: [
+    { name: "token", type: "address" }, { name: "market", type: "tuple", components: lifecycleMarketComponents },
+  ], outputs: [
+    { name: "deployer", type: "address" }, { name: "initCodeHash", type: "bytes32" },
+    { name: "salt", type: "bytes32" }, { name: "predictedHook", type: "address" },
+  ] },
+] as const;
+const boundParametersInput = { name: "parameters", type: "tuple", components: poolBoundHookParametersV1Components } as const;
+export const poolHookDeployerV1Abi = [
+  { type: "constructor", stateMutability: "nonpayable", inputs: [{ name: "creationCode", type: "bytes" }] },
+  { type: "function", name: "creationCodeHash", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "codeChunk0", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "codeChunk1", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "deployedCodeHash", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "initCodeHash", stateMutability: "view", inputs: [boundParametersInput], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "predict", stateMutability: "view", inputs: [boundParametersInput, { name: "salt", type: "bytes32" }], outputs: [{ type: "address" }] },
+  { type: "function", name: "validHookAddress", stateMutability: "pure", inputs: [{ type: "address" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "deploy", stateMutability: "nonpayable", inputs: [boundParametersInput, { name: "salt", type: "bytes32" }], outputs: [{ name: "hook", type: "address" }] },
+] as const;
+export const sharedHookDeployerV1Abi = [
+  { type: "constructor", stateMutability: "nonpayable", inputs: [{ name: "creationCode", type: "bytes" }] },
+  { type: "function", name: "creationCodeHash", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "codeChunk0", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "codeChunk1", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "deployedCodeHash", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "predict", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }, { type: "address" }, { type: "bytes32" }], outputs: [{ type: "address" }] },
+] as const;
+export const lifecycleV4PoolKeyComponents = [
+  { name: "currency0", type: "address" }, { name: "currency1", type: "address" }, { name: "fee", type: "uint24" },
+  { name: "tickSpacing", type: "int24" }, { name: "hooks", type: "address" },
+] as const;
+export const lifecycleV4HookPoolConfigComponents = [
+  { name: "collector", type: "address" }, { name: "liquidityLocker", type: "address" }, { name: "quoteCurrency", type: "address" },
+  { name: "feeMode", type: "uint8" }, { name: "hookFeePips", type: "uint24" }, { name: "protocolFeeDenominator", type: "uint8" },
+  { name: "treasury", type: "address" }, { name: "externalLiquidityDisabled", type: "bool" }, { name: "oracleConfigId", type: "bytes32" },
+] as const;
+export const lifecycleV4HookAbi = [
+  { type: "function", name: "poolManager", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "registrar", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "oracleFactory", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "REQUIRED_HOOK_FLAGS", stateMutability: "view", inputs: [], outputs: [{ type: "uint160" }] },
+  { type: "function", name: "ALL_HOOK_MASK", stateMutability: "view", inputs: [], outputs: [{ type: "uint160" }] },
+  { type: "function", name: "registered", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "initialized", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "openingCompletedAt", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "oracleInitializedAt", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "poolKey", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: lifecycleV4PoolKeyComponents }] },
+  { type: "function", name: "poolConfig", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "tuple", components: lifecycleV4HookPoolConfigComponents }] },
+  { type: "function", name: "registerPool", stateMutability: "nonpayable", inputs: [{ type: "tuple", components: lifecycleV4PoolKeyComponents }, { type: "tuple", components: lifecycleV4HookPoolConfigComponents }], outputs: [] },
+  { type: "function", name: "completePoolOpening", stateMutability: "nonpayable", inputs: [{ type: "tuple", components: lifecycleV4PoolKeyComponents }], outputs: [] },
+  { type: "function", name: "validateCollector", stateMutability: "view", inputs: [{ type: "tuple", components: lifecycleV4PoolKeyComponents }, { type: "address" }, { type: "address" }], outputs: [] },
+  { type: "function", name: "collectFees", stateMutability: "nonpayable", inputs: [{ type: "tuple", components: lifecycleV4PoolKeyComponents }], outputs: [{ type: "uint256" }, { type: "uint256" }] },
+  { type: "function", name: "validateOracleConfig", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "uint24" }, { type: "uint16" }] },
+  { type: "function", name: "observeTruncated", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "uint32[]" }], outputs: [{ type: "int56[]" }, { type: "uint160[]" }] },
+  { type: "function", name: "increaseObservationCardinalityNext", stateMutability: "nonpayable", inputs: [{ type: "bytes32" }, { type: "uint16" }], outputs: [] },
+  { type: "function", name: "pendingFees", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "settledFees", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "address" }], outputs: [{ type: "uint256" }] },
+] as const;
+export const poolBoundLaunchFeeHookV1Abi = [
+  ...lifecycleV4HookAbi,
+  { type: "constructor", stateMutability: "nonpayable", inputs: [boundParametersInput] },
+  { type: "function", name: "boundPoolId", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "deploymentConfigHash", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "marketCommitment", stateMutability: "view", inputs: [], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "core", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "liquidityLocker", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "token", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "openingSqrtPriceX96", stateMutability: "view", inputs: [], outputs: [{ type: "uint160" }] },
+  { type: "function", name: "expectedPositionCount", stateMutability: "view", inputs: [], outputs: [{ type: "uint32" }] },
+] as const;
+export const lifecycleV4LockerAbi = [
+  { type: "function", name: "poolManager", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "launcher", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "positionCount", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "isSealed", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "bool" }] },
+] as const;
+export const poolFeeCollectorFactoryV1Abi = [
+  { type: "function", name: "collectorDeployer", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "poolBoundHookParameters", stateMutability: "view", inputs: [
+    { name: "registrar", type: "address" }, { name: "token", type: "address" }, { name: "market", type: "tuple", components: lifecycleMarketComponents },
+  ], outputs: [boundParametersInput, { name: "salt", type: "bytes32" }] },
+  { type: "function", name: "decodeAndValidate", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }, { type: "tuple", components: lifecycleMarketComponents }], outputs: [{ type: "tuple", components: v4LifecycleMarketComponents }] },
+  { type: "function", name: "poolBoundDeploymentMetadata", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }, { type: "tuple", components: lifecycleMarketComponents }], outputs: [{ type: "address" }, { type: "bytes32" }, { type: "bytes32" }, { type: "address" }] },
+  { type: "function", name: "dependencyDigest", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bytes32" }] },
+  { type: "function", name: "create", stateMutability: "nonpayable", inputs: [{ type: "address" }, { type: "address" }, { type: "tuple", components: lifecycleV4PoolKeyComponents }, { type: "uint256" }], outputs: [{ type: "address" }] },
+] as const;
+export const lifecycleDirectoryAbi = [
+  { type: "function", name: "core", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "market", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "uint32" }], outputs: [{ name: "adapter", type: "address" }, { name: "prepared", type: "tuple", components: preparedMarketV1Components }] },
+  { type: "function", name: "positions", stateMutability: "view", inputs: [{ type: "bytes32" }, { type: "uint32" }, { type: "uint256" }, { type: "uint256" }], outputs: [{ type: "tuple[]", components: positionIdentityV1Components }] },
+  { type: "function", name: "launches", stateMutability: "view", inputs: [{ type: "uint256" }, { type: "uint256" }], outputs: [{ type: "bytes32[]" }] },
+  { type: "function", name: "launchOfToken", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bytes32" }] },
+] as const;
+export const lifecycleFundingEscrowAbi = [
+  { type: "function", name: "core", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "wrappedNative", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+] as const;
+export const lifecycleErc20Abi = [
+  { type: "function", name: "balanceOf", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "allowance", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "approve", stateMutability: "nonpayable", inputs: [{ type: "address" }, { type: "uint256" }], outputs: [{ type: "bool" }] },
+] as const;
+export const lifecycleOracleFactoryAbi = [
+  { type: "function", name: "oracleConfigs", stateMutability: "view", inputs: [{ type: "bytes32" }], outputs: [{ type: "uint24" }, { type: "uint16" }] },
+] as const;
+export const lifecycleFeeHubAbi = [
+  { type: "function", name: "economicVersion", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "implementationRegistry", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "protocolMaximumDeveloperFeeBps", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "configurator", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "launchToken", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "feeOwnerRegistry", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "rewards", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "requiresOwner", stateMutability: "view", inputs: [], outputs: [{ type: "bool" }] },
+  { type: "function", name: "requiresRewards", stateMutability: "view", inputs: [], outputs: [{ type: "bool" }] },
+  { type: "function", name: "rewardAssets", stateMutability: "view", inputs: [], outputs: [{ type: "address[]" }] },
+  { type: "function", name: "sourceAssets", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "address[]" }] },
+  { type: "function", name: "sourceTerms", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "tuple", components: sourceTermsV3Components }] },
+  { type: "function", name: "claimableDeveloperFees", stateMutability: "view", inputs: [{ type: "address" }, { type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "reservedDeveloperFees", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "claimDeveloperFees", stateMutability: "nonpayable", inputs: [{ name: "authorId", type: "address" }, { name: "asset", type: "address" }], outputs: [{ name: "amount", type: "uint256" }] },
+  { type: "event", name: "DeveloperFeesClaimed", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "asset", type: "address", indexed: true },
+    { name: "payout", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false },
+  ] },
+  { type: "event", name: "DeveloperFeesCredited", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "source", type: "address", indexed: true },
+    { name: "asset", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false },
+  ] },
+  { type: "error", name: "UnsupportedAsset", inputs: [] },
+  { type: "function", name: "MAX_EXECUTOR_FEE_BPS", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "executorFeeBps", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "setExecutorFeeBps", stateMutability: "nonpayable", inputs: [{ name: "newFeeBps", type: "uint16" }], outputs: [] },
+  { type: "event", name: "ExecutorFeeUpdated", inputs: [{ name: "feeOwner", type: "address", indexed: true }, { name: "previousFeeBps", type: "uint16", indexed: false }, { name: "newFeeBps", type: "uint16", indexed: false }], anonymous: false },
+  { type: "function", name: "finalized", stateMutability: "view", inputs: [], outputs: [{ type: "bool" }] },
+  { type: "function", name: "assets", stateMutability: "view", inputs: [], outputs: [{ type: "address[]" }] },
+  { type: "function", name: "sources", stateMutability: "view", inputs: [], outputs: [{ type: "address[]" }] },
+  { type: "function", name: "policy", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "tuple", components: lifecycleFeePolicyComponents }] },
+  { type: "function", name: "claimAndSplit", stateMutability: "nonpayable", inputs: [], outputs: [{ type: "tuple[]", components: [{ name: "asset", type: "address" }, { name: "amount", type: "uint256" }] }] },
+  { type: "event", name: "Distributed", anonymous: false, inputs: [
+    { name: "asset", type: "address", indexed: true }, { name: "owner", type: "address", indexed: true }, { name: "executor", type: "address", indexed: true },
+    { name: "newlyCollected", type: "uint256", indexed: false }, { name: "executorAmount", type: "uint256", indexed: false },
+    { name: "ownerAmount", type: "uint256", indexed: false }, { name: "developerAmount", type: "uint256", indexed: false },
+    { name: "rewardsAmount", type: "uint256", indexed: false }, { name: "burnAmount", type: "uint256", indexed: false },
+  ] },
+  { type: "function", name: "claimableOwnerFees", stateMutability: "view", inputs: [{ name: "owner", type: "address" }, { name: "asset", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "reservedOwnerFees", stateMutability: "view", inputs: [{ name: "asset", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "claimOwnerFees", stateMutability: "nonpayable", inputs: [{ name: "asset", type: "address" }, { name: "recipient", type: "address" }], outputs: [{ name: "amount", type: "uint256" }] },
+  { type: "event", name: "OwnerFeesCredited", inputs: [{ name: "owner", type: "address", indexed: true }, { name: "asset", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false }], anonymous: false },
+  { type: "event", name: "OwnerFeesClaimed", inputs: [{ name: "owner", type: "address", indexed: true }, { name: "asset", type: "address", indexed: true }, { name: "recipient", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false }], anonymous: false },
+] as const;
+export const developerClaimResultV3Components = [
+  { name: "hub", type: "address" }, { name: "asset", type: "address" }, { name: "amount", type: "uint256" },
+  { name: "status", type: "uint8" }, { name: "errorSelector", type: "bytes4" },
+] as const;
+export const lifecycleFeeHubFactoryAbi = [
+  { type: "function", name: "isHub", stateMutability: "view", inputs: [{ type: "address" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "implementationRegistry", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "deploymentAuthority", stateMutability: "view", inputs: [], outputs: [{ type: "address" }] },
+  { type: "function", name: "claimDeveloperFeesPage", stateMutability: "nonpayable", inputs: [
+    { name: "authorId", type: "address" }, { name: "offset", type: "uint256" }, { name: "limit", type: "uint256" }, { name: "assets", type: "address[]" },
+  ], outputs: [{ name: "results", type: "tuple[]", components: developerClaimResultV3Components }, { name: "nextOffset", type: "uint256" }, { name: "total", type: "uint256" }] },
+  { type: "event", name: "DeveloperClaimResult", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "hub", type: "address", indexed: true },
+    { name: "asset", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false },
+    { name: "status", type: "uint8", indexed: false }, { name: "errorSelector", type: "bytes4", indexed: false },
+  ] },
+  { type: "event", name: "DeveloperClaimPage", anonymous: false, inputs: [
+    { name: "authorId", type: "address", indexed: true }, { name: "offset", type: "uint256", indexed: false },
+    { name: "nextOffset", type: "uint256", indexed: false }, { name: "total", type: "uint256", indexed: false },
+  ] },
+] as const;
+
+/** Multiasset staking and dividend claims; return values and RewardPaid are beneficiary net. */
+export const lifecycleRewardsAbi = [
+  { type: "function", name: "rewardAssets", stateMutability: "view", inputs: [], outputs: [{ type: "address[]" }] },
+  { type: "function", name: "earned", stateMutability: "view", inputs: [{ name: "beneficiary", type: "address" }, { name: "asset", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "pendingRewards", stateMutability: "view", inputs: [{ name: "beneficiary", type: "address" }], outputs: [{ type: "uint256[]" }] },
+  { type: "function", name: "lifetimeRewardsPaid", stateMutability: "view", inputs: [{ name: "asset", type: "address" }, { name: "beneficiary", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "claim", stateMutability: "nonpayable", inputs: [], outputs: [{ type: "uint256[]" }] },
+  { type: "function", name: "claimFor", stateMutability: "nonpayable", inputs: [{ name: "beneficiary", type: "address" }], outputs: [{ type: "uint256[]" }] },
+  { type: "function", name: "claimRange", stateMutability: "nonpayable", inputs: [{ name: "beneficiary", type: "address" }, { name: "start", type: "uint256" }, { name: "count", type: "uint256" }], outputs: [{ type: "uint256[]" }] },
+  { type: "event", name: "RewardPaid", inputs: [{ name: "beneficiary", type: "address", indexed: true }, { name: "asset", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false }], anonymous: false },
+  { type: "event", name: "RewardClaimBountyPaid", inputs: [{ name: "executor", type: "address", indexed: true }, { name: "beneficiary", type: "address", indexed: true }, { name: "asset", type: "address", indexed: true }, { name: "amount", type: "uint256", indexed: false }], anonymous: false },
+] as const;
+
+/** Dividend-only policy; initially zero, controlled by the token's current registered fee owner. */
+export const lifecycleDividendAbi = [
+  ...lifecycleRewardsAbi,
+  { type: "function", name: "MAX_DIVIDEND_BOUNTY_BPS", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "dividendBountyBps", stateMutability: "view", inputs: [], outputs: [{ type: "uint16" }] },
+  { type: "function", name: "setDividendBountyBps", stateMutability: "nonpayable", inputs: [{ name: "newBountyBps", type: "uint16" }], outputs: [] },
+  { type: "event", name: "DividendBountyUpdated", inputs: [{ name: "feeOwner", type: "address", indexed: true }, { name: "previousBountyBps", type: "uint16", indexed: false }, { name: "newBountyBps", type: "uint16", indexed: false }], anonymous: false },
+] as const;

package/src/lifecycle/authors.ts

@@ -0,0 +1,203 @@
+import { decodeEventLog, encodeFunctionData, isAddress, zeroAddress, type Address, type Hex } from "viem";
+import { launchLifecycleAbi, lifecycleFeeHubAbi, lifecycleFeeHubFactoryAbi, lifecycleRegistryAbi } from "./abi.js";
+import { assertLifecycleBlock, lifecycleRpc, readLifecycleBlock, readLifecycleContract, rpcQuantity } from "./rpc.js";
+import type { SourceTermsV3 } from "./schema.js";
+import { LifecyclePlanningError, type LifecycleBlock, type LifecycleRpcClient } from "./types.js";
+
+export type LifecycleUnsignedTransaction = { chainId: number; from: Address; to: Address; data: Hex; value: bigint };
+export type LifecycleAuthorOptions = { client: LifecycleRpcClient; registry: Address; authorId: Address };
+export type LifecycleAuthor = {
+  registry: Address; core: Address; factory: Address; authorId: Address; payout: Address; known: boolean;
+  hubCount: bigint; chainId: bigint; blockNumber: bigint; blockHash: Hex;
+};
+export type AuthorHubsPage = LifecycleAuthor & { hubs: readonly Address[]; offset: bigint; nextOffset: bigint; total: bigint; cursorComplete: boolean };
+export type DeveloperFees = LifecycleAuthor & {
+  hub: Address; assets: readonly Address[];
+  balances: readonly { asset: Address; supported: boolean; claimable: bigint; reserved: bigint }[];
+  sources: readonly { source: Address; assets: readonly Address[]; terms: SourceTermsV3 }[];
+};
+export type DeveloperClaimTransaction = LifecycleUnsignedTransaction & {
+  claim: { kind: "direct"; registry: Address; factory: Address; authorId: Address; hub: Address; asset: Address }
+    | { kind: "page"; registry: Address; factory: Address; authorId: Address; offset: bigint; limit: bigint; assets: readonly Address[] };
+};
+export type DeveloperClaimResult = { hub: Address; asset: Address; amount: bigint; status: 0 | 1 | 2 | 3; outcome: "paid" | "zero" | "unsupported" | "failed"; errorSelector: Hex; payout?: Address };
+export type DeveloperClaimReceipt = {
+  executionSucceeded: boolean; outcome: "observed" | "unobserved" | "reverted";
+  results: readonly DeveloperClaimResult[]; retryableResults: readonly DeveloperClaimResult[];
+  cursorComplete: boolean; paymentsSucceeded: boolean; offset?: bigint; nextOffset?: bigint; total?: bigint; reason?: string;
+};
+export type DeveloperClaimReceiptInput = {
+  status: "success" | "reverted" | "0x1" | "0x0" | number | bigint;
+  from: Address; to: Address | null; transactionHash?: Hex;
+  logs: readonly { address: Address; data: Hex; topics: readonly Hex[]; removed?: boolean }[];
+};
+
+function requireAddress(address: Address, label: string): void {
+  if (!isAddress(address) || address.toLowerCase() === zeroAddress) throw new LifecyclePlanningError("INVALID_AUTHOR_ADDRESS", `${label} must be a nonzero address`);
+}
+function validateAssets(assets: readonly Address[]): void {
+  if (assets.length > 8) throw new LifecyclePlanningError("INVALID_CLAIM_ASSETS", "Claims accept at most eight explicit assets");
+  let previous = 0n;
+  for (const asset of assets) {
+    requireAddress(asset, "Claim asset");
+    if (BigInt(asset) <= previous) throw new LifecyclePlanningError("INVALID_CLAIM_ASSETS", "Explicit assets must be sorted, unique and nonzero");
+    previous = BigInt(asset);
+  }
+}
+function requirePage(offset: bigint, limit: bigint, maximum: bigint): void {
+  if (offset < 0n || offset >= 1n << 256n || limit < 1n || limit > maximum) throw new LifecyclePlanningError("INVALID_AUTHOR_PAGE", `Page offset must be uint256 and limit must be 1..${maximum}`);
+}
+async function readAuthorContext(options: LifecycleAuthorOptions, block: LifecycleBlock): Promise<LifecycleAuthor> {
+  const { client, registry, authorId } = options;
+  requireAddress(registry, "Implementation registry"); requireAddress(authorId, "Stable author identity");
+  const chainId = rpcQuantity(await lifecycleRpc(client, "eth_chainId"), "author chain ID");
+  const core = await readLifecycleContract<Address>(client, registry, lifecycleRegistryAbi, "core", [], block);
+  requireAddress(core, "Registry core");
+  if ((await readLifecycleContract<Address>(client, core, launchLifecycleAbi, "registry", [], block)).toLowerCase() !== registry.toLowerCase()) throw new LifecyclePlanningError("REGISTRY_BINDING", "Selected core does not bind this implementation registry");
+  const factory = await readLifecycleContract<Address>(client, core, launchLifecycleAbi, "feeFactory", [], block);
+  requireAddress(factory, "Canonical fee factory");
+  if ((await readLifecycleContract<Address>(client, factory, lifecycleFeeHubFactoryAbi, "implementationRegistry", [], block)).toLowerCase() !== registry.toLowerCase() ||
+    (await readLifecycleContract<Address>(client, factory, lifecycleFeeHubFactoryAbi, "deploymentAuthority", [], block)).toLowerCase() !== core.toLowerCase()) throw new LifecyclePlanningError("FEE_FACTORY_BINDING", "Canonical fee factory differs from the selected registry/core domain");
+  const payout = await readLifecycleContract<Address>(client, registry, lifecycleRegistryAbi, "authorPayout", [authorId], block);
+  const hubCount = await readLifecycleContract<bigint>(client, registry, lifecycleRegistryAbi, "authorHubCount", [authorId], block);
+  return { registry, core, factory, authorId, payout, known: payout.toLowerCase() !== zeroAddress, hubCount, chainId, blockNumber: block.number, blockHash: block.hash };
+}
+async function requireCanonicalHub(client: LifecycleRpcClient, author: LifecycleAuthor, hub: Address, block: LifecycleBlock): Promise<void> {
+  requireAddress(hub, "Developer fee hub");
+  // Membership is checked through registry.core -> core.feeFactory, before ANY hub self-report.
+  if (!await readLifecycleContract<boolean>(client, author.factory, lifecycleFeeHubFactoryAbi, "isHub", [hub], block)) throw new LifecyclePlanningError("UNAUTHENTICATED_HUB", "Hub is not a member of this registry core's canonical V3 factory");
+  if (await readLifecycleContract<number>(client, hub, lifecycleFeeHubAbi, "economicVersion", [], block) !== 3 ||
+    (await readLifecycleContract<Address>(client, hub, lifecycleFeeHubAbi, "implementationRegistry", [], block)).toLowerCase() !== author.registry.toLowerCase() ||
+    (await readLifecycleContract<Address>(client, hub, lifecycleFeeHubAbi, "configurator", [], block)).toLowerCase() !== author.core.toLowerCase()) throw new LifecyclePlanningError("FEE_HUB_BINDING", "Canonical hub does not implement the selected V3 economic domain");
+}
+function unsignedTransaction(options: { account: Address; chainId: bigint }, author: LifecycleAuthor, to: Address, data: Hex): LifecycleUnsignedTransaction {
+  requireAddress(options.account, "Transaction account");
+  if (options.chainId !== author.chainId || options.chainId <= 0n || options.chainId > BigInt(Number.MAX_SAFE_INTEGER)) throw new LifecyclePlanningError("CHAIN_MISMATCH", "Unsigned transaction chain must exactly match the selected author domain");
+  return { chainId: Number(options.chainId), from: options.account, to, data, value: 0n };
+}
+
+export async function readLifecycleAuthor(options: LifecycleAuthorOptions, pinnedBlock?: LifecycleBlock): Promise<LifecycleAuthor> {
+  const block = pinnedBlock ?? await readLifecycleBlock(options.client);
+  const author = await readAuthorContext(options, block);
+  if (pinnedBlock === undefined) await assertLifecycleBlock(options.client, block);
+  return author;
+}
+export async function readAuthorHubs(options: LifecycleAuthorOptions & { offset?: bigint; limit?: bigint }, pinnedBlock?: LifecycleBlock): Promise<AuthorHubsPage> {
+  const offset = options.offset ?? 0n; const limit = options.limit ?? 100n;
+  requirePage(offset, limit, 100n);
+  const block = pinnedBlock ?? await readLifecycleBlock(options.client);
+  const author = await readAuthorContext(options, block);
+  if (offset > author.hubCount) throw new LifecyclePlanningError("INVALID_AUTHOR_PAGE", "Author discovery offset exceeds the registered hub count");
+  const [hubs, nextOffset, total] = await readLifecycleContract<readonly [readonly Address[], bigint, bigint]>(options.client, options.registry, lifecycleRegistryAbi, "authorHubs", [options.authorId, offset, limit], block);
+  if (total !== author.hubCount || nextOffset !== offset + BigInt(hubs.length) || nextOffset > total || BigInt(hubs.length) > limit) throw new LifecyclePlanningError("INVALID_AUTHOR_PAGE", "Registry returned an inconsistent discovery cursor");
+  for (const hub of hubs) await requireCanonicalHub(options.client, author, hub, block);
+  if (pinnedBlock === undefined) await assertLifecycleBlock(options.client, block);
+  return { ...author, hubs, offset, nextOffset, total, cursorComplete: nextOffset === total };
+}
+export async function readDeveloperFees(options: LifecycleAuthorOptions & { hub: Address; assets?: readonly Address[] }, pinnedBlock?: LifecycleBlock): Promise<DeveloperFees> {
+  const explicitAssets = options.assets ?? [];
+  validateAssets(explicitAssets);
+  const block = pinnedBlock ?? await readLifecycleBlock(options.client);
+  const author = await readAuthorContext(options, block);
+  await requireCanonicalHub(options.client, author, options.hub, block);
+  const assets = await readLifecycleContract<readonly Address[]>(options.client, options.hub, lifecycleFeeHubAbi, "assets", [], block);
+  const selected = explicitAssets.length === 0 ? assets : explicitAssets;
+  const balances: { asset: Address; supported: boolean; claimable: bigint; reserved: bigint }[] = [];
+  for (const asset of selected) {
+    const supported = assets.some((actual) => actual.toLowerCase() === asset.toLowerCase());
+    const claimable = supported ? await readLifecycleContract<bigint>(options.client, options.hub, lifecycleFeeHubAbi, "claimableDeveloperFees", [options.authorId, asset], block) : 0n;
+    const reserved = supported ? await readLifecycleContract<bigint>(options.client, options.hub, lifecycleFeeHubAbi, "reservedDeveloperFees", [asset], block) : 0n;
+    balances.push({ asset, supported, claimable, reserved });
+  }
+  const sources: { source: Address; assets: readonly Address[]; terms: SourceTermsV3 }[] = [];
+  for (const source of await readLifecycleContract<readonly Address[]>(options.client, options.hub, lifecycleFeeHubAbi, "sources", [], block)) {
+    sources.push({ source, assets: await readLifecycleContract<readonly Address[]>(options.client, options.hub, lifecycleFeeHubAbi, "sourceAssets", [source], block),
+      terms: await readLifecycleContract<SourceTermsV3>(options.client, options.hub, lifecycleFeeHubAbi, "sourceTerms", [source], block) });
+  }
+  if (pinnedBlock === undefined) await assertLifecycleBlock(options.client, block);
+  return { ...author, hub: options.hub, assets, balances, sources };
+}
+export async function buildSetAuthorPayoutTransaction(options: LifecycleAuthorOptions & { payout: Address; account: Address; chainId: bigint }): Promise<LifecycleUnsignedTransaction> {
+  requireAddress(options.payout, "New payout/controller");
+  const block = await readLifecycleBlock(options.client);
+  const author = await readAuthorContext(options, block);
+  if (!author.known) throw new LifecyclePlanningError("UNKNOWN_AUTHOR", "Cannot set a payout for an unknown stable author identity");
+  const admin = await readLifecycleContract<Address>(options.client, options.registry, lifecycleRegistryAbi, "admin", [], block);
+  if (![author.payout, admin].some((address) => address.toLowerCase() === options.account.toLowerCase())) throw new LifecyclePlanningError("AUTHOR_AUTHORIZATION", "Only the registry admin or current live payout/controller may change routing");
+  const transaction = unsignedTransaction(options, author, options.registry, encodeFunctionData({ abi: lifecycleRegistryAbi, functionName: "setAuthorPayout", args: [options.authorId, options.payout] }));
+  await assertLifecycleBlock(options.client, block);
+  return transaction;
+}
+export async function buildClaimDeveloperFeesTransaction(options: LifecycleAuthorOptions & { hub: Address; asset: Address; account: Address; chainId: bigint }): Promise<DeveloperClaimTransaction> {
+  requireAddress(options.asset, "Developer fee asset");
+  const block = await readLifecycleBlock(options.client);
+  const author = await readAuthorContext(options, block);
+  await requireCanonicalHub(options.client, author, options.hub, block);
+  const assets = await readLifecycleContract<readonly Address[]>(options.client, options.hub, lifecycleFeeHubAbi, "assets", [], block);
+  if (!assets.some((asset) => asset.toLowerCase() === options.asset.toLowerCase())) throw new LifecyclePlanningError("UNSUPPORTED_ASSET", "Direct developer claims require an asset supported by this canonical hub");
+  const transaction = unsignedTransaction(options, author, options.hub, encodeFunctionData({ abi: lifecycleFeeHubAbi, functionName: "claimDeveloperFees", args: [options.authorId, options.asset] }));
+  await assertLifecycleBlock(options.client, block);
+  return { ...transaction, claim: { kind: "direct", registry: options.registry, factory: author.factory, authorId: options.authorId, hub: options.hub, asset: options.asset } };
+}
+export async function buildClaimDeveloperFeesPageTransaction(options: LifecycleAuthorOptions & { offset: bigint; limit: bigint; assets?: readonly Address[]; account: Address; chainId: bigint }): Promise<DeveloperClaimTransaction> {
+  const assets = [...options.assets ?? []];
+  validateAssets(assets); requirePage(options.offset, options.limit, 10n);
+  const block = await readLifecycleBlock(options.client);
+  const page = await readAuthorHubs(options, block);
+  const transaction = unsignedTransaction(options, page, page.factory, encodeFunctionData({ abi: lifecycleFeeHubFactoryAbi, functionName: "claimDeveloperFeesPage", args: [options.authorId, options.offset, options.limit, assets] }));
+  await assertLifecycleBlock(options.client, block);
+  return { ...transaction, claim: { kind: "page", registry: options.registry, factory: page.factory, authorId: options.authorId, offset: options.offset, limit: options.limit, assets } };
+}
+
+/** Receipt logs report payment facts, not pending credits or a promise that every cursor row paid. */
+export function decodeDeveloperClaimReceipt(options: { receipt: DeveloperClaimReceiptInput; transaction: DeveloperClaimTransaction }): DeveloperClaimReceipt {
+  const { receipt, transaction } = options; const claim = transaction.claim;
+  if (receipt.from.toLowerCase() !== transaction.from.toLowerCase() || receipt.to?.toLowerCase() !== transaction.to.toLowerCase() || transaction.value !== 0n) throw new LifecyclePlanningError("CLAIM_RECEIPT_IDENTITY", "Receipt account/target differs from the unsigned claim context");
+  const expectedData = claim.kind === "direct"
+    ? encodeFunctionData({ abi: lifecycleFeeHubAbi, functionName: "claimDeveloperFees", args: [claim.authorId, claim.asset] })
+    : encodeFunctionData({ abi: lifecycleFeeHubFactoryAbi, functionName: "claimDeveloperFeesPage", args: [claim.authorId, claim.offset, claim.limit, claim.assets] });
+  if (transaction.data.toLowerCase() !== expectedData.toLowerCase() || transaction.to.toLowerCase() !== (claim.kind === "direct" ? claim.hub : claim.factory).toLowerCase()) throw new LifecyclePlanningError("CLAIM_RECEIPT_IDENTITY", "Unsigned context does not encode this exact fixed-destination claim");
+  const executionSucceeded = ["success", "0x1", 1, 1n].includes(receipt.status);
+  if (!executionSucceeded) {
+    if (!["reverted", "0x0", 0, 0n].includes(receipt.status)) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Receipt status is not a canonical success/revert value");
+    return { executionSucceeded: false, outcome: "reverted", results: [], retryableResults: [], cursorComplete: false, paymentsSucceeded: false, reason: "Claim execution reverted; no payment or cursor advancement occurred" };
+  }
+  const results: DeveloperClaimResult[] = [];
+  let cursor: { offset: bigint; nextOffset: bigint; total: bigint } | undefined;
+  const seen = new Set<string>();
+  for (const log of receipt.logs) {
+    if (log.address.toLowerCase() !== transaction.to.toLowerCase()) continue;
+    if (log.removed) throw new LifecyclePlanningError("CLAIM_RECEIPT_REORGED", "Removed claim logs cannot prove payment");
+    if (claim.kind === "direct") {
+      let event;
+      try { event = decodeEventLog({ abi: lifecycleFeeHubAbi, data: log.data, topics: log.topics as [Hex, ...Hex[]], strict: true }); } catch { continue; }
+      if (event.eventName !== "DeveloperFeesClaimed") continue;
+      if (event.args.authorId.toLowerCase() !== claim.authorId.toLowerCase() || event.args.asset.toLowerCase() !== claim.asset.toLowerCase() || event.args.amount === 0n || results.length !== 0) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Direct payment event differs from the expected author/asset or is duplicated");
+      results.push({ hub: claim.hub, asset: event.args.asset, amount: event.args.amount, status: 0, outcome: "paid", errorSelector: "0x00000000", payout: event.args.payout });
+    } else {
+      let event;
+      try { event = decodeEventLog({ abi: lifecycleFeeHubFactoryAbi, data: log.data, topics: log.topics as [Hex, ...Hex[]], strict: true }); } catch { continue; }
+      if (event.eventName === "DeveloperClaimPage") {
+        if (event.args.authorId.toLowerCase() !== claim.authorId.toLowerCase() || event.args.offset !== claim.offset || cursor !== undefined || event.args.nextOffset < claim.offset || event.args.nextOffset > event.args.total || event.args.nextOffset - claim.offset > claim.limit) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Page cursor differs from the bounded expected claim");
+        cursor = { offset: event.args.offset, nextOffset: event.args.nextOffset, total: event.args.total };
+      } else if (event.eventName === "DeveloperClaimResult") {
+        const { authorId, hub, asset, amount, status, errorSelector } = event.args;
+        const key = `${hub.toLowerCase()}:${asset.toLowerCase()}`;
+        if (authorId.toLowerCase() !== claim.authorId.toLowerCase() || status > 3 || seen.has(key) ||
+          (claim.assets.length !== 0 && !claim.assets.some((selected) => selected.toLowerCase() === asset.toLowerCase())) ||
+          (status === 0 ? amount === 0n : amount !== 0n) || (status < 2 && errorSelector !== "0x00000000")) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Factory result has a mismatched author, asset, status, amount or duplicate row");
+        seen.add(key);
+        results.push({ hub, asset, amount, status: status as 0 | 1 | 2 | 3, outcome: (["paid", "zero", "unsupported", "failed"] as const)[status]!, errorSelector });
+      }
+    }
+  }
+  if (claim.kind === "page") {
+    if (cursor === undefined) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Successful page receipt lacks the canonical cursor event");
+    const hubCount = BigInt(new Set(results.map((result) => result.hub.toLowerCase())).size);
+    if (hubCount !== cursor.nextOffset - cursor.offset || (claim.assets.length !== 0 && BigInt(results.length) !== hubCount * BigInt(claim.assets.length))) throw new LifecyclePlanningError("INVALID_CLAIM_RECEIPT", "Receipt rows do not account for every hub/asset in the observed cursor page");
+  }
+  return { executionSucceeded: true, outcome: results.length !== 0 || cursor !== undefined ? "observed" : "unobserved", results,
+    retryableResults: results.filter((result) => result.status === 3), cursorComplete: cursor !== undefined && cursor.nextOffset === cursor.total,
+    paymentsSucceeded: (results.length !== 0 || cursor !== undefined) && results.every((result) => result.status < 2), ...cursor,
+    reason: claim.kind === "direct" && results.length === 0 ? "No direct payment event is present; zero credit is possible, but an amount is not receipt-proven" : undefined };
+}