@nokinc-flur/sdk 1.0.6 → 1.1.1

package/dist/index.d.ts

@@ -922,6 +922,8 @@ type AccountActivityItem = {
     timestamp: string;
 };
 type AccountSummaryResponse = {
+    userId: string;
+    nuban: string | null;
     balance: number;
     currency: string;
     dailySendLimit: number;
@@ -4923,4 +4925,1523 @@ type PartnerProfileAdminClient = {
 };
 declare function createPartnerProfileAdminClient(opts: PartnerProfileAdminClientOptions): PartnerProfileAdminClient;
 
-export { ACCOUNT_STATUSES, ACCOUNT_TYPES, ADDITIONAL_DATA_SUBFIELD, type Account, type AccountActivityItem, type AccountMembership, AccountMembershipSchema, AccountSchema, type AccountStatus, type AccountSummaryResponse, type AccountType, type AccountsClient, type AccountsClientOptions, type AddMemberInput, type AdditionalData, type ApiCredentialPublic, ApiCredentialPublicSchema, type ApiCredentialsAdminClient, type AtomicRedeemReceiptInput, type AtomicRedeemResponse, type AuthLogoutInput, type AuthRefreshInput, type AuthRefreshResponse, type AuthorizeSendWithBiometricInput, type AuthorizedOptions, type BiometricSigner, type BuildPassInput, type BuildReceiptInput, type BuildRedemptionInput, COLLECTION_INTENT_STATUSES, COLLECTION_PAYMENT_STATUSES, CUSTODIAL_MODES, type CashNamespace, type CollectionIntent, CollectionIntentSchema, type CollectionPayment, type CollectionPaymentResult, CollectionPaymentResultSchema, CollectionPaymentSchema, type CollectionReportSummary, CollectionReportSummarySchema, type CollectionStatement, CollectionStatementSchema, type CollectionsClient, type CollectionsClientOptions, type ConsumerCollectionsClient, type ConsumerOAC, type OACRecord as ConsumerOACRecord, OACRecordSchema as ConsumerOACRecordSchema, ConsumerOACSchema, type ConsumerPaymentClaim, ConsumerPaymentClaimSchema, type ConsumerSettleResult, ConsumerSettleResultSchema, type ConsumerSettlement, ConsumerSettlementSchema, type ConsumerWithdrawalsClient, type ConsumerWithdrawalsClientOptions, type CreateBusinessAccountInput, type CreateCollectionIntentInput, CreateCollectionIntentInputSchema, type CreatePayLinkResponse, type CreatePayoutDestinationInput, CreatePayoutDestinationInputSchema, type CreatePayoutInput, CreatePayoutInputSchema, type CreateTransferOptions, type CreateWithdrawalInput, CreateWithdrawalInputSchema, type CreateWithdrawalResult, CreateWithdrawalResultSchema, type CustodialMode, type DeviceKeyRecord, DeviceKeyRecordSchema, type DeviceTrustState, type DisableOfflineInput, DisableOfflineInputSchema, type DisableOfflineResult, DisableOfflineResultSchema, type Ed25519KeyPair, type EnableOfflineInput, EnableOfflineInputSchema, type EnableOfflineResult, EnableOfflineResultSchema, FIELD, FlurApiError, FlurCapExceededError, FlurClient, type FlurClientOptions, FlurError, type FlurErrorCode, FlurExpiredError, type FlurHandle, type FlurInitOptions, type FlurOfflineSettlementsClient, type FlurPartnerClient, type FlurPaymentEvent, FlurReplayError, type HmacFetchOptions, type IngestFundingResult, IngestFundingResultSchema, type IssueOACInput, IssueOACInputSchema, type IssueOfflineTokenInput, type IssuePassInput, type IssueReceiptInput, type ListPassesInput, type ListPassesResponse, type ListPayoutDestinationsResult, ListPayoutDestinationsResultSchema, type ListReceiptsInput, type ListReceiptsResponse, type ListTransactionsOptions, MEMBERSHIP_ROLES, MERCHANT_PAYOUT_STATUSES, MERCHANT_PROFILE_STATUSES, type MeOfflineClient, type MeOfflineClientOptions, type MembershipRole, type MerchantAccountInfo, type MerchantPayout, MerchantPayoutSchema, type MerchantProfile, MerchantProfileSchema, type MintedApiCredential, MintedApiCredentialSchema, type Money, NGN_CURRENCY_CODE, NG_COUNTRY_CODE, NQRParseError, type NQRPayloadInput, type OAC, OACSchema, OAC_DEFAULT_CUMULATIVE_KOBO, OAC_DEFAULT_PER_TX_KOBO, OAC_DEFAULT_VALIDITY_MS, type OfflineHoldRecord, OfflineHoldRecordSchema, type OfflinePaymentAuthorization, OfflinePaymentAuthorizationSchema, type OfflinePaymentRequest, OfflinePaymentRequestSchema, type OfflineStateResult, OfflineStateResultSchema, type OfflineStatusResult, OfflineStatusResultSchema, type OfflineToken, OfflineTokenSchema, type OnboardingCompleteInput, type OnboardingCompleteResponse, type OnboardingFallback, type OnboardingRiskReason, type OnboardingStartInput, type OnboardingStartResponse, PARTNER_FUNDING_DIRECTIONS, PARTNER_FUNDING_STATUSES, PARTNER_KINDS, PARTNER_PROFILE_STATUSES, PARTNER_SCOPES, PASS_KINDS, PASS_STATES, PAYLOAD_FORMAT_INDICATOR_VALUE, PAYOUT_DESTINATION_STATUSES, POINT_OF_INITIATION, type ParsedNQR, type PartnerClientOptions, type PartnerCollectionsClient, type PartnerFunding, type PartnerFundingClient, type PartnerFundingDirection, type PartnerFundingEventInput, PartnerFundingEventInputSchema, PartnerFundingSchema, type PartnerFundingStatus, type PartnerKind, type PartnerProfile, type PartnerProfileAdminClient, type PartnerProfileAdminClientOptions, PartnerProfileSchema, type PartnerProfileStatus, type PartnerScope, type PartnerSignResult, type Pass, type PassKind, type PassMetadata, PassMetadataSchema, PassSchema, type PassState, type PassesClient, type PassesClientOptions, type PayCollectionInput, PayCollectionInputSchema, type PayCollectionOptions, type PayCollectionResponse, type PaymentClaim, PaymentClaimSchema, type PayoutDestination, PayoutDestinationSchema, type PayoutDestinationStatus, type PayoutEventInput, PayoutEventInputSchema, type PinSetInput, type PinVerifyInput, type ProviderEventInput, ProviderEventInputSchema, type ProviderEventRecord, ProviderEventRecordSchema, type PublicCollectionIntent, PublicCollectionIntentSchema, type PushPlatform, type PushRegisterInput, RECEIPT_CHANNELS, RECEIPT_KINDS, REPLAY_WINDOW_MS, type Receipt, type ReceiptChannel, type ReceiptKind, type ReceiptPayload, ReceiptPayloadSchema, ReceiptSchema, type ReceiptsClient, type ReceiptsClientOptions, type RecipientResolveInput, type RecipientResolveResponse, type ReconciliationReport, ReconciliationReportSchema, type RecordPayoutEventResult, RecordPayoutEventResultSchema, type RedeemPassResponse, type Redemption, RedemptionSchema, type RegisterDeviceInput, type RegisterDeviceKeyInput, RegisterDeviceKeyInputSchema, type RegisterDeviceResponse, type RegisterSendDeviceKeyInput, type ResolveCollectionOptions, type ResolveCollectionResponse, type ResolvePayLinkResponse, RevokeDeviceKeyInputSchema, type RevokePassInput, type RoutingHint, SETTLEMENT_SCHEDULES, type SendChallengeInput, type SendChallengeResponse, type SendMoneyInput, type SendMoneyOptions, type SendVerifyInput, type SendVerifyResponse, type SettleResponse, SettleResponseSchema, type Settlement, SettlementSchema, type SignedConsumerOAC, SignedConsumerOACSchema, type SubscribeOptions, type TLVField, type TransactionDetailResponse, type TransactionDirection, type TransactionsListResponse, type TransferInput, type TransferResponse, type TransferStatus, type UnsignedOAC, type UnsignedOfflinePaymentAuthorization, type UnsignedOfflinePaymentRequest, type UnsignedPass, type UnsignedReceipt, type UnsignedRedemption, type UpsertMerchantProfileInput, UpsertMerchantProfileInputSchema, type UpsertPartnerProfileInput, UpsertPartnerProfileInputSchema, WITHDRAWAL_STATES, type Withdrawal, WithdrawalSchema, type WithdrawalState, bodySha256Hex, buildAuthorization, buildOAC, buildPass, buildPaymentRequest, buildReceipt, buildRedemption, canonicalJSONBytes, canonicalJSONStringify, canonicalRequestString, computeEncounterId, constantTimeEqual, crc16ccitt, crc16ccittHex, createAccountsClient, createApiCredentialsAdminClient, createCollectionsClient, createConsumerCollectionsClient, createConsumerWithdrawalsClient, createFlurPartnerClient, createHmacFetch, createMeOfflineClient, createOfflineSettlementsClient, createPartnerCollectionsClient, createPartnerFundingClient, createPartnerProfileAdminClient, createPassesClient, createReceiptsClient, decodeAuthorizationQR, decodeBase45, decodePaymentRequestQR, encodeAuthorizationQR, encodeBase45, encodeNQR, encodePaymentRequestQR, formatAmount, generateDynamicQR, generateKeyPair, generateStaticQR, init, isPassWithinValidity, moneyMinorToNumber, normalizeE164, parseAmountInput, parseNQR, parseQR, publicKeyFromPrivate, readTLV, routingHint, sign, signAuthorization, signCanonical, signOAC, signPartnerRequest, signPass, signPaymentRequest, signReceipt, signRedemption, signRequestHMAC, verify, verifyAuthorization, verifyCanonical, verifyOAC, verifyPass, verifyPaymentRequest, verifyReceipt, verifyRedemption, verifyRequestHMAC, writeTLV };
+/**
+ * Flur v1 Signed Artifact envelope.
+ *
+ * URI form:
+ *   flur://v1/<artifact-type>/<base64url(canonical-json(body))>.<base64url(sig)>
+ *
+ * Body shape (canonical JSON, sorted keys):
+ *   {
+ *     v:     1,                  // envelope version
+ *     t:     '<artifact-type>',  // matches the URI segment (redundant for safety)
+ *     iss:   '<issuer-id>',      // user/merchant/partner id
+ *     kid:   '<device-key-id>',  // identifier of the signing device key
+ *     iat:   <epoch-seconds>,    // issued-at
+ *     exp?:  <epoch-seconds>,    // optional expiry
+ *     nonce: '<string>',         // unique per artifact (replay guard)
+ *     data:  <artifact body>     // type-specific, validated by registered schema
+ *   }
+ *
+ * Signature: Ed25519 over canonicalJSONBytes(body), hex-encoded (64 bytes / 128 hex chars).
+ *
+ * Design notes:
+ * - URI scheme `flur://v1/...` is the single transport for all signed artifacts.
+ * - Scanners route on the path segment; verifiers look up the issuer/kid public key.
+ * - Pure NIBSS NQR payments remain unchanged; this envelope rides separately.
+ */
+declare const FLUR_ARTIFACT_URI_SCHEME = "flur";
+declare const FLUR_ARTIFACT_VERSION = 1;
+declare const FLUR_ARTIFACT_URI_PREFIX = "flur://v1/";
+declare const ArtifactHeaderSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    t: z.ZodString;
+    iss: z.ZodString;
+    kid: z.ZodString;
+    iat: z.ZodNumber;
+    exp: z.ZodOptional<z.ZodNumber>;
+    nonce: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    nonce: string;
+    t: string;
+    v: 1;
+    iss: string;
+    kid: string;
+    iat: number;
+    exp?: number | undefined;
+}, {
+    nonce: string;
+    t: string;
+    v: 1;
+    iss: string;
+    kid: string;
+    iat: number;
+    exp?: number | undefined;
+}>;
+type ArtifactHeader = z.infer<typeof ArtifactHeaderSchema>;
+type ArtifactBody<T = unknown> = ArtifactHeader & {
+    data: T;
+};
+type SignedArtifact<T = unknown> = {
+    body: ArtifactBody<T>;
+    sig: string;
+};
+declare class FlurArtifactError extends Error {
+    code: 'INVALID_URI' | 'INVALID_TYPE' | 'INVALID_BODY' | 'INVALID_SIGNATURE' | 'EXPIRED' | 'TYPE_MISMATCH';
+    constructor(message: string, code: 'INVALID_URI' | 'INVALID_TYPE' | 'INVALID_BODY' | 'INVALID_SIGNATURE' | 'EXPIRED' | 'TYPE_MISMATCH');
+}
+declare function base64UrlEncode(bytes: Uint8Array): string;
+declare function base64UrlDecode(s: string): Uint8Array;
+declare function buildArtifactBody<T>(input: {
+    type: string;
+    issuer: string;
+    keyId: string;
+    data: T;
+    issuedAtSeconds?: number;
+    expiresAtSeconds?: number;
+    nonce: string;
+}): ArtifactBody<T>;
+declare function signArtifact<T>(body: ArtifactBody<T>, privateKey: Uint8Array): SignedArtifact<T>;
+declare function encodeArtifactUri<T>(signed: SignedArtifact<T>): string;
+type DecodedArtifactUri = {
+    type: string;
+    bodyBytes: Uint8Array;
+    body: ArtifactBody;
+    sig: string;
+};
+declare function decodeArtifactUri(uri: string): DecodedArtifactUri;
+type VerifyArtifactOptions = {
+    /** Caller-supplied current time (seconds). Defaults to Date.now()/1000. */
+    nowSeconds?: number;
+    /** When true (default), reject artifacts whose `exp` is in the past. */
+    enforceExpiry?: boolean;
+};
+declare function verifyArtifactSignature(decoded: DecodedArtifactUri, publicKey: Uint8Array, options?: VerifyArtifactOptions): boolean;
+
+/**
+ * Registry of all Flur v1 signed artifact types.
+ *
+ * Each artifact has:
+ *  - a string discriminator (used in the URI path segment & header `t`),
+ *  - a Zod schema validating the `data` payload only (envelope header is validated separately).
+ *
+ * Two artifacts are fully specified in this slice (OPA + Receipt) as the
+ * canonical implementation pattern. The remaining nine carry stub schemas
+ * (`z.unknown()`) so types compile and the registry is complete; bodies
+ * will be locked in subsequent slices once their backend ledger shapes
+ * are finalised.
+ */
+declare const ARTIFACT_TYPES: {
+    readonly OFFLINE_PAYMENT_AUTHORIZATION: "offline_payment_authorization";
+    readonly RECEIPT: "receipt";
+    readonly NQR_PAYMENT_REQUEST: "nqr_payment_request";
+    readonly PAYMENT_INTENT: "payment_intent";
+    readonly OFFLINE_CLAIM: "offline_claim";
+    readonly SETTLEMENT_RECORD: "settlement_record";
+    readonly REVERSAL_RECORD: "reversal_record";
+    readonly LEDGER_JOURNAL_ENTRY: "ledger_journal_entry";
+    readonly STATEMENT: "statement";
+    readonly PASS: "pass";
+    readonly IDENTITY: "identity";
+};
+type ArtifactType = (typeof ARTIFACT_TYPES)[keyof typeof ARTIFACT_TYPES];
+declare const OfflinePaymentAuthorizationArtifactSchema: z.ZodObject<{
+    authorization: z.ZodObject<{
+        request: z.ZodObject<{
+            reference: z.ZodString;
+            amountKobo: z.ZodNumber;
+            merchantOAC: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+                userId: z.ZodString;
+                deviceId: z.ZodString;
+                devicePublicKey: z.ZodString;
+                perTxCapKobo: z.ZodNumber;
+                cumulativeCapKobo: z.ZodNumber;
+                validFromMs: z.ZodNumber;
+                validUntilMs: z.ZodNumber;
+                counterSeed: z.ZodNumber;
+                nonce: z.ZodString;
+                issuerSig: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>;
+            expiresAtMs: z.ZodNumber;
+            merchantSig: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        }, {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        }>;
+        payerOAC: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            userId: z.ZodString;
+            deviceId: z.ZodString;
+            devicePublicKey: z.ZodString;
+            perTxCapKobo: z.ZodNumber;
+            cumulativeCapKobo: z.ZodNumber;
+            validFromMs: z.ZodNumber;
+            validUntilMs: z.ZodNumber;
+            counterSeed: z.ZodNumber;
+            nonce: z.ZodString;
+            issuerSig: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }>, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }>, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }, {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        }>;
+        payerCounter: z.ZodNumber;
+        payerSig: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        request: {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        };
+        payerOAC: {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        };
+        payerCounter: number;
+        payerSig: string;
+    }, {
+        request: {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        };
+        payerOAC: {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        };
+        payerCounter: number;
+        payerSig: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    authorization: {
+        request: {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        };
+        payerOAC: {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        };
+        payerCounter: number;
+        payerSig: string;
+    };
+}, {
+    authorization: {
+        request: {
+            reference: string;
+            amountKobo: number;
+            expiresAtMs: number;
+            merchantOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            merchantSig: string;
+        };
+        payerOAC: {
+            userId: string;
+            deviceId: string;
+            nonce: string;
+            devicePublicKey: string;
+            perTxCapKobo: number;
+            cumulativeCapKobo: number;
+            validFromMs: number;
+            validUntilMs: number;
+            counterSeed: number;
+            issuerSig: string;
+        };
+        payerCounter: number;
+        payerSig: string;
+    };
+}>;
+type OfflinePaymentAuthorizationArtifact = z.infer<typeof OfflinePaymentAuthorizationArtifactSchema>;
+declare const ReceiptArtifactSchema: z.ZodObject<{
+    receiptId: z.ZodString;
+    paymentReference: z.ZodString;
+    payerUserId: z.ZodOptional<z.ZodString>;
+    payeeUserId: z.ZodString;
+    amountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    channel: z.ZodEnum<["online", "offline_reconciled", "pay_link", "nqr"]>;
+    settledAtMs: z.ZodNumber;
+    ledgerTxnId: z.ZodOptional<z.ZodString>;
+    memo: z.ZodOptional<z.ZodString>;
+    hashChainPrev: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    amountKobo: number;
+    payeeUserId: string;
+    receiptId: string;
+    channel: "online" | "offline_reconciled" | "pay_link" | "nqr";
+    paymentReference: string;
+    settledAtMs: number;
+    payerUserId?: string | undefined;
+    ledgerTxnId?: string | undefined;
+    memo?: string | undefined;
+    hashChainPrev?: string | undefined;
+}, {
+    currency: "NGN";
+    amountKobo: number;
+    payeeUserId: string;
+    receiptId: string;
+    channel: "online" | "offline_reconciled" | "pay_link" | "nqr";
+    paymentReference: string;
+    settledAtMs: number;
+    payerUserId?: string | undefined;
+    ledgerTxnId?: string | undefined;
+    memo?: string | undefined;
+    hashChainPrev?: string | undefined;
+}>;
+type ReceiptArtifact = z.infer<typeof ReceiptArtifactSchema>;
+declare const NqrPaymentRequestArtifactSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    payeeUserId: z.ZodString;
+    amountKobo: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodLiteral<"NGN">;
+    memo: z.ZodOptional<z.ZodString>;
+    expiresAtMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    currency: "NGN";
+    payeeUserId: string;
+    amountKobo?: number | undefined;
+    expiresAtMs?: number | undefined;
+    memo?: string | undefined;
+}, {
+    requestId: string;
+    currency: "NGN";
+    payeeUserId: string;
+    amountKobo?: number | undefined;
+    expiresAtMs?: number | undefined;
+    memo?: string | undefined;
+}>;
+declare const PaymentIntentArtifactSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    payerUserId: z.ZodString;
+    payeeUserId: z.ZodString;
+    amountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    idempotencyKey: z.ZodString;
+    createdAtMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    createdAtMs: number;
+    intentId: string;
+    amountKobo: number;
+    idempotencyKey: string;
+    payerUserId: string;
+    payeeUserId: string;
+}, {
+    currency: "NGN";
+    createdAtMs: number;
+    intentId: string;
+    amountKobo: number;
+    idempotencyKey: string;
+    payerUserId: string;
+    payeeUserId: string;
+}>;
+declare const OfflineClaimArtifactSchema: z.ZodObject<{
+    claimId: z.ZodString;
+    authorizationId: z.ZodString;
+    payeeUserId: z.ZodString;
+    claimedAmountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    claimedAtMs: z.ZodNumber;
+    paymentReference: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    payeeUserId: string;
+    claimId: string;
+    authorizationId: string;
+    claimedAmountKobo: number;
+    claimedAtMs: number;
+    paymentReference?: string | undefined;
+}, {
+    currency: "NGN";
+    payeeUserId: string;
+    claimId: string;
+    authorizationId: string;
+    claimedAmountKobo: number;
+    claimedAtMs: number;
+    paymentReference?: string | undefined;
+}>;
+declare const SettlementRecordArtifactSchema: z.ZodObject<{
+    settlementId: z.ZodString;
+    ledgerTxnId: z.ZodString;
+    sourceRefType: z.ZodEnum<["offline_authorization", "offline_claim", "transfer", "pay_link"]>;
+    sourceRefId: z.ZodString;
+    amountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    settledAtMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    amountKobo: number;
+    settlementId: string;
+    settledAtMs: number;
+    ledgerTxnId: string;
+    sourceRefType: "offline_claim" | "pay_link" | "offline_authorization" | "transfer";
+    sourceRefId: string;
+}, {
+    currency: "NGN";
+    amountKobo: number;
+    settlementId: string;
+    settledAtMs: number;
+    ledgerTxnId: string;
+    sourceRefType: "offline_claim" | "pay_link" | "offline_authorization" | "transfer";
+    sourceRefId: string;
+}>;
+declare const ReversalRecordArtifactSchema: z.ZodObject<{
+    reversalId: z.ZodString;
+    originalTxnId: z.ZodString;
+    amountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    reason: z.ZodEnum<["user_dispute", "fraud", "duplicate", "admin_correction", "other"]>;
+    reversedAtMs: z.ZodNumber;
+    memo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    amountKobo: number;
+    reversalId: string;
+    originalTxnId: string;
+    reason: "user_dispute" | "fraud" | "duplicate" | "admin_correction" | "other";
+    reversedAtMs: number;
+    memo?: string | undefined;
+}, {
+    currency: "NGN";
+    amountKobo: number;
+    reversalId: string;
+    originalTxnId: string;
+    reason: "user_dispute" | "fraud" | "duplicate" | "admin_correction" | "other";
+    reversedAtMs: number;
+    memo?: string | undefined;
+}>;
+declare const LedgerJournalEntryArtifactSchema: z.ZodObject<{
+    entryId: z.ZodString;
+    journalId: z.ZodString;
+    debitAccountId: z.ZodString;
+    creditAccountId: z.ZodString;
+    amountKobo: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    postedAtMs: z.ZodNumber;
+    refType: z.ZodOptional<z.ZodString>;
+    refId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: "NGN";
+    amountKobo: number;
+    entryId: string;
+    journalId: string;
+    debitAccountId: string;
+    creditAccountId: string;
+    postedAtMs: number;
+    refType?: string | undefined;
+    refId?: string | undefined;
+}, {
+    currency: "NGN";
+    amountKobo: number;
+    entryId: string;
+    journalId: string;
+    debitAccountId: string;
+    creditAccountId: string;
+    postedAtMs: number;
+    refType?: string | undefined;
+    refId?: string | undefined;
+}>;
+declare const StatementArtifactSchema: z.ZodEffects<z.ZodObject<{
+    statementId: z.ZodString;
+    userId: z.ZodString;
+    periodStartMs: z.ZodNumber;
+    periodEndMs: z.ZodNumber;
+    openingBalanceKobo: z.ZodNumber;
+    closingBalanceKobo: z.ZodNumber;
+    transactionCount: z.ZodNumber;
+    currency: z.ZodLiteral<"NGN">;
+    hashChainPrev: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    currency: "NGN";
+    statementId: string;
+    periodStartMs: number;
+    periodEndMs: number;
+    openingBalanceKobo: number;
+    closingBalanceKobo: number;
+    transactionCount: number;
+    hashChainPrev?: string | undefined;
+}, {
+    userId: string;
+    currency: "NGN";
+    statementId: string;
+    periodStartMs: number;
+    periodEndMs: number;
+    openingBalanceKobo: number;
+    closingBalanceKobo: number;
+    transactionCount: number;
+    hashChainPrev?: string | undefined;
+}>, {
+    userId: string;
+    currency: "NGN";
+    statementId: string;
+    periodStartMs: number;
+    periodEndMs: number;
+    openingBalanceKobo: number;
+    closingBalanceKobo: number;
+    transactionCount: number;
+    hashChainPrev?: string | undefined;
+}, {
+    userId: string;
+    currency: "NGN";
+    statementId: string;
+    periodStartMs: number;
+    periodEndMs: number;
+    openingBalanceKobo: number;
+    closingBalanceKobo: number;
+    transactionCount: number;
+    hashChainPrev?: string | undefined;
+}>;
+declare const PassArtifactSchema: z.ZodEffects<z.ZodObject<{
+    passId: z.ZodString;
+    holderId: z.ZodString;
+    category: z.ZodEnum<["membership", "ticket", "loyalty", "access", "voucher"]>;
+    title: z.ZodString;
+    validFromMs: z.ZodNumber;
+    validUntilMs: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, "strip", z.ZodTypeAny, {
+    validFromMs: number;
+    passId: string;
+    holderId: string;
+    category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+    title: string;
+    metadata?: Record<string, string | number | boolean> | undefined;
+    validUntilMs?: number | undefined;
+}, {
+    validFromMs: number;
+    passId: string;
+    holderId: string;
+    category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+    title: string;
+    metadata?: Record<string, string | number | boolean> | undefined;
+    validUntilMs?: number | undefined;
+}>, {
+    validFromMs: number;
+    passId: string;
+    holderId: string;
+    category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+    title: string;
+    metadata?: Record<string, string | number | boolean> | undefined;
+    validUntilMs?: number | undefined;
+}, {
+    validFromMs: number;
+    passId: string;
+    holderId: string;
+    category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+    title: string;
+    metadata?: Record<string, string | number | boolean> | undefined;
+    validUntilMs?: number | undefined;
+}>;
+declare const IdentityArtifactSchema: z.ZodObject<{
+    attestationId: z.ZodString;
+    subjectId: z.ZodString;
+    claimType: z.ZodEnum<["phone_verified", "email_verified", "bvn_verified", "kyc_tier", "age_band"]>;
+    claimValueHash: z.ZodString;
+    attestedAtMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    attestationId: string;
+    subjectId: string;
+    claimType: "phone_verified" | "email_verified" | "bvn_verified" | "kyc_tier" | "age_band";
+    claimValueHash: string;
+    attestedAtMs: number;
+}, {
+    attestationId: string;
+    subjectId: string;
+    claimType: "phone_verified" | "email_verified" | "bvn_verified" | "kyc_tier" | "age_band";
+    claimValueHash: string;
+    attestedAtMs: number;
+}>;
+declare const ARTIFACT_BODY_SCHEMAS: {
+    readonly offline_payment_authorization: z.ZodObject<{
+        authorization: z.ZodObject<{
+            request: z.ZodObject<{
+                reference: z.ZodString;
+                amountKobo: z.ZodNumber;
+                merchantOAC: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+                    userId: z.ZodString;
+                    deviceId: z.ZodString;
+                    devicePublicKey: z.ZodString;
+                    perTxCapKobo: z.ZodNumber;
+                    cumulativeCapKobo: z.ZodNumber;
+                    validFromMs: z.ZodNumber;
+                    validUntilMs: z.ZodNumber;
+                    counterSeed: z.ZodNumber;
+                    nonce: z.ZodString;
+                    issuerSig: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }>, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }>, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }, {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                }>;
+                expiresAtMs: z.ZodNumber;
+                merchantSig: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            }, {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            }>;
+            payerOAC: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+                userId: z.ZodString;
+                deviceId: z.ZodString;
+                devicePublicKey: z.ZodString;
+                perTxCapKobo: z.ZodNumber;
+                cumulativeCapKobo: z.ZodNumber;
+                validFromMs: z.ZodNumber;
+                validUntilMs: z.ZodNumber;
+                counterSeed: z.ZodNumber;
+                nonce: z.ZodString;
+                issuerSig: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }, {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            }>;
+            payerCounter: z.ZodNumber;
+            payerSig: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            request: {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            };
+            payerOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            payerCounter: number;
+            payerSig: string;
+        }, {
+            request: {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            };
+            payerOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            payerCounter: number;
+            payerSig: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        authorization: {
+            request: {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            };
+            payerOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            payerCounter: number;
+            payerSig: string;
+        };
+    }, {
+        authorization: {
+            request: {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            };
+            payerOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            payerCounter: number;
+            payerSig: string;
+        };
+    }>;
+    readonly receipt: z.ZodObject<{
+        receiptId: z.ZodString;
+        paymentReference: z.ZodString;
+        payerUserId: z.ZodOptional<z.ZodString>;
+        payeeUserId: z.ZodString;
+        amountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        channel: z.ZodEnum<["online", "offline_reconciled", "pay_link", "nqr"]>;
+        settledAtMs: z.ZodNumber;
+        ledgerTxnId: z.ZodOptional<z.ZodString>;
+        memo: z.ZodOptional<z.ZodString>;
+        hashChainPrev: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        amountKobo: number;
+        payeeUserId: string;
+        receiptId: string;
+        channel: "online" | "offline_reconciled" | "pay_link" | "nqr";
+        paymentReference: string;
+        settledAtMs: number;
+        payerUserId?: string | undefined;
+        ledgerTxnId?: string | undefined;
+        memo?: string | undefined;
+        hashChainPrev?: string | undefined;
+    }, {
+        currency: "NGN";
+        amountKobo: number;
+        payeeUserId: string;
+        receiptId: string;
+        channel: "online" | "offline_reconciled" | "pay_link" | "nqr";
+        paymentReference: string;
+        settledAtMs: number;
+        payerUserId?: string | undefined;
+        ledgerTxnId?: string | undefined;
+        memo?: string | undefined;
+        hashChainPrev?: string | undefined;
+    }>;
+    readonly nqr_payment_request: z.ZodObject<{
+        requestId: z.ZodString;
+        payeeUserId: z.ZodString;
+        amountKobo: z.ZodOptional<z.ZodNumber>;
+        currency: z.ZodLiteral<"NGN">;
+        memo: z.ZodOptional<z.ZodString>;
+        expiresAtMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        requestId: string;
+        currency: "NGN";
+        payeeUserId: string;
+        amountKobo?: number | undefined;
+        expiresAtMs?: number | undefined;
+        memo?: string | undefined;
+    }, {
+        requestId: string;
+        currency: "NGN";
+        payeeUserId: string;
+        amountKobo?: number | undefined;
+        expiresAtMs?: number | undefined;
+        memo?: string | undefined;
+    }>;
+    readonly payment_intent: z.ZodObject<{
+        intentId: z.ZodString;
+        payerUserId: z.ZodString;
+        payeeUserId: z.ZodString;
+        amountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        idempotencyKey: z.ZodString;
+        createdAtMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        createdAtMs: number;
+        intentId: string;
+        amountKobo: number;
+        idempotencyKey: string;
+        payerUserId: string;
+        payeeUserId: string;
+    }, {
+        currency: "NGN";
+        createdAtMs: number;
+        intentId: string;
+        amountKobo: number;
+        idempotencyKey: string;
+        payerUserId: string;
+        payeeUserId: string;
+    }>;
+    readonly offline_claim: z.ZodObject<{
+        claimId: z.ZodString;
+        authorizationId: z.ZodString;
+        payeeUserId: z.ZodString;
+        claimedAmountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        claimedAtMs: z.ZodNumber;
+        paymentReference: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        payeeUserId: string;
+        claimId: string;
+        authorizationId: string;
+        claimedAmountKobo: number;
+        claimedAtMs: number;
+        paymentReference?: string | undefined;
+    }, {
+        currency: "NGN";
+        payeeUserId: string;
+        claimId: string;
+        authorizationId: string;
+        claimedAmountKobo: number;
+        claimedAtMs: number;
+        paymentReference?: string | undefined;
+    }>;
+    readonly settlement_record: z.ZodObject<{
+        settlementId: z.ZodString;
+        ledgerTxnId: z.ZodString;
+        sourceRefType: z.ZodEnum<["offline_authorization", "offline_claim", "transfer", "pay_link"]>;
+        sourceRefId: z.ZodString;
+        amountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        settledAtMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        amountKobo: number;
+        settlementId: string;
+        settledAtMs: number;
+        ledgerTxnId: string;
+        sourceRefType: "offline_claim" | "pay_link" | "offline_authorization" | "transfer";
+        sourceRefId: string;
+    }, {
+        currency: "NGN";
+        amountKobo: number;
+        settlementId: string;
+        settledAtMs: number;
+        ledgerTxnId: string;
+        sourceRefType: "offline_claim" | "pay_link" | "offline_authorization" | "transfer";
+        sourceRefId: string;
+    }>;
+    readonly reversal_record: z.ZodObject<{
+        reversalId: z.ZodString;
+        originalTxnId: z.ZodString;
+        amountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        reason: z.ZodEnum<["user_dispute", "fraud", "duplicate", "admin_correction", "other"]>;
+        reversedAtMs: z.ZodNumber;
+        memo: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        amountKobo: number;
+        reversalId: string;
+        originalTxnId: string;
+        reason: "user_dispute" | "fraud" | "duplicate" | "admin_correction" | "other";
+        reversedAtMs: number;
+        memo?: string | undefined;
+    }, {
+        currency: "NGN";
+        amountKobo: number;
+        reversalId: string;
+        originalTxnId: string;
+        reason: "user_dispute" | "fraud" | "duplicate" | "admin_correction" | "other";
+        reversedAtMs: number;
+        memo?: string | undefined;
+    }>;
+    readonly ledger_journal_entry: z.ZodObject<{
+        entryId: z.ZodString;
+        journalId: z.ZodString;
+        debitAccountId: z.ZodString;
+        creditAccountId: z.ZodString;
+        amountKobo: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        postedAtMs: z.ZodNumber;
+        refType: z.ZodOptional<z.ZodString>;
+        refId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        currency: "NGN";
+        amountKobo: number;
+        entryId: string;
+        journalId: string;
+        debitAccountId: string;
+        creditAccountId: string;
+        postedAtMs: number;
+        refType?: string | undefined;
+        refId?: string | undefined;
+    }, {
+        currency: "NGN";
+        amountKobo: number;
+        entryId: string;
+        journalId: string;
+        debitAccountId: string;
+        creditAccountId: string;
+        postedAtMs: number;
+        refType?: string | undefined;
+        refId?: string | undefined;
+    }>;
+    readonly statement: z.ZodEffects<z.ZodObject<{
+        statementId: z.ZodString;
+        userId: z.ZodString;
+        periodStartMs: z.ZodNumber;
+        periodEndMs: z.ZodNumber;
+        openingBalanceKobo: z.ZodNumber;
+        closingBalanceKobo: z.ZodNumber;
+        transactionCount: z.ZodNumber;
+        currency: z.ZodLiteral<"NGN">;
+        hashChainPrev: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        currency: "NGN";
+        statementId: string;
+        periodStartMs: number;
+        periodEndMs: number;
+        openingBalanceKobo: number;
+        closingBalanceKobo: number;
+        transactionCount: number;
+        hashChainPrev?: string | undefined;
+    }, {
+        userId: string;
+        currency: "NGN";
+        statementId: string;
+        periodStartMs: number;
+        periodEndMs: number;
+        openingBalanceKobo: number;
+        closingBalanceKobo: number;
+        transactionCount: number;
+        hashChainPrev?: string | undefined;
+    }>, {
+        userId: string;
+        currency: "NGN";
+        statementId: string;
+        periodStartMs: number;
+        periodEndMs: number;
+        openingBalanceKobo: number;
+        closingBalanceKobo: number;
+        transactionCount: number;
+        hashChainPrev?: string | undefined;
+    }, {
+        userId: string;
+        currency: "NGN";
+        statementId: string;
+        periodStartMs: number;
+        periodEndMs: number;
+        openingBalanceKobo: number;
+        closingBalanceKobo: number;
+        transactionCount: number;
+        hashChainPrev?: string | undefined;
+    }>;
+    readonly pass: z.ZodEffects<z.ZodObject<{
+        passId: z.ZodString;
+        holderId: z.ZodString;
+        category: z.ZodEnum<["membership", "ticket", "loyalty", "access", "voucher"]>;
+        title: z.ZodString;
+        validFromMs: z.ZodNumber;
+        validUntilMs: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, "strip", z.ZodTypeAny, {
+        validFromMs: number;
+        passId: string;
+        holderId: string;
+        category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+        title: string;
+        metadata?: Record<string, string | number | boolean> | undefined;
+        validUntilMs?: number | undefined;
+    }, {
+        validFromMs: number;
+        passId: string;
+        holderId: string;
+        category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+        title: string;
+        metadata?: Record<string, string | number | boolean> | undefined;
+        validUntilMs?: number | undefined;
+    }>, {
+        validFromMs: number;
+        passId: string;
+        holderId: string;
+        category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+        title: string;
+        metadata?: Record<string, string | number | boolean> | undefined;
+        validUntilMs?: number | undefined;
+    }, {
+        validFromMs: number;
+        passId: string;
+        holderId: string;
+        category: "voucher" | "loyalty" | "membership" | "ticket" | "access";
+        title: string;
+        metadata?: Record<string, string | number | boolean> | undefined;
+        validUntilMs?: number | undefined;
+    }>;
+    readonly identity: z.ZodObject<{
+        attestationId: z.ZodString;
+        subjectId: z.ZodString;
+        claimType: z.ZodEnum<["phone_verified", "email_verified", "bvn_verified", "kyc_tier", "age_band"]>;
+        claimValueHash: z.ZodString;
+        attestedAtMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        attestationId: string;
+        subjectId: string;
+        claimType: "phone_verified" | "email_verified" | "bvn_verified" | "kyc_tier" | "age_band";
+        claimValueHash: string;
+        attestedAtMs: number;
+    }, {
+        attestationId: string;
+        subjectId: string;
+        claimType: "phone_verified" | "email_verified" | "bvn_verified" | "kyc_tier" | "age_band";
+        claimValueHash: string;
+        attestedAtMs: number;
+    }>;
+};
+/** Artifact types whose body schema is fully specified and safe to dispatch. */
+declare const HARDENED_ARTIFACT_TYPES: Set<ArtifactType>;
+declare function isKnownArtifactType(t: string): t is ArtifactType;
+declare function isHardenedArtifactType(t: string): t is ArtifactType;
+
+/**
+ * Build, sign and encode a typed artifact into a flur://v1/... URI.
+ *
+ * - Validates the body against the registered Zod schema for `type`.
+ * - Refuses unknown artifact types.
+ * - Refuses stub types (those without a hardened schema) to avoid shipping
+ *   unverifiable payloads.
+ */
+declare function createArtifactUri<T>(input: {
+    type: ArtifactType;
+    issuer: string;
+    keyId: string;
+    privateKey: Uint8Array;
+    data: T;
+    nonce: string;
+    issuedAtSeconds?: number;
+    expiresAtSeconds?: number;
+}): {
+    uri: string;
+    signed: SignedArtifact<T>;
+};
+type VerifiedArtifact<T = unknown> = {
+    type: ArtifactType;
+    body: ArtifactBody<T>;
+    sig: string;
+    decoded: DecodedArtifactUri;
+};
+/**
+ * Decode and verify a flur://v1/... URI.
+ *
+ * - Parses the URI and envelope header.
+ * - Validates the body against the registered Zod schema.
+ * - Verifies the Ed25519 signature against the supplied public key.
+ * - Enforces expiry unless `options.enforceExpiry === false`.
+ *
+ * The caller is responsible for resolving the public key from (issuer, kid)
+ * against the backend device-key registry, and for enforcing nonce uniqueness
+ * via the artifact_nonces store.
+ */
+declare function verifyArtifactUri<T = unknown>(uri: string, publicKey: Uint8Array, options?: VerifyArtifactOptions): VerifiedArtifact<T>;
+declare function createReceiptArtifactUri(input: {
+    issuer: string;
+    keyId: string;
+    privateKey: Uint8Array;
+    data: ReceiptArtifact;
+    nonce: string;
+    issuedAtSeconds?: number;
+    expiresAtSeconds?: number;
+}): {
+    uri: string;
+    signed: SignedArtifact<{
+        currency: "NGN";
+        amountKobo: number;
+        payeeUserId: string;
+        receiptId: string;
+        channel: "online" | "offline_reconciled" | "pay_link" | "nqr";
+        paymentReference: string;
+        settledAtMs: number;
+        payerUserId?: string | undefined;
+        ledgerTxnId?: string | undefined;
+        memo?: string | undefined;
+        hashChainPrev?: string | undefined;
+    }>;
+};
+declare function createOfflinePaymentAuthorizationArtifactUri(input: {
+    issuer: string;
+    keyId: string;
+    privateKey: Uint8Array;
+    data: OfflinePaymentAuthorizationArtifact;
+    nonce: string;
+    issuedAtSeconds?: number;
+    expiresAtSeconds?: number;
+}): {
+    uri: string;
+    signed: SignedArtifact<{
+        authorization: {
+            request: {
+                reference: string;
+                amountKobo: number;
+                expiresAtMs: number;
+                merchantOAC: {
+                    userId: string;
+                    deviceId: string;
+                    nonce: string;
+                    devicePublicKey: string;
+                    perTxCapKobo: number;
+                    cumulativeCapKobo: number;
+                    validFromMs: number;
+                    validUntilMs: number;
+                    counterSeed: number;
+                    issuerSig: string;
+                };
+                merchantSig: string;
+            };
+            payerOAC: {
+                userId: string;
+                deviceId: string;
+                nonce: string;
+                devicePublicKey: string;
+                perTxCapKobo: number;
+                cumulativeCapKobo: number;
+                validFromMs: number;
+                validUntilMs: number;
+                counterSeed: number;
+                issuerSig: string;
+            };
+            payerCounter: number;
+            payerSig: string;
+        };
+    }>;
+};
+
+export { ACCOUNT_STATUSES, ACCOUNT_TYPES, ADDITIONAL_DATA_SUBFIELD, ARTIFACT_BODY_SCHEMAS, ARTIFACT_TYPES, type Account, type AccountActivityItem, type AccountMembership, AccountMembershipSchema, AccountSchema, type AccountStatus, type AccountSummaryResponse, type AccountType, type AccountsClient, type AccountsClientOptions, type AddMemberInput, type AdditionalData, type ApiCredentialPublic, ApiCredentialPublicSchema, type ApiCredentialsAdminClient, type ArtifactBody, type ArtifactHeader, ArtifactHeaderSchema, type ArtifactType, type AtomicRedeemReceiptInput, type AtomicRedeemResponse, type AuthLogoutInput, type AuthRefreshInput, type AuthRefreshResponse, type AuthorizeSendWithBiometricInput, type AuthorizedOptions, type BiometricSigner, type BuildPassInput, type BuildReceiptInput, type BuildRedemptionInput, COLLECTION_INTENT_STATUSES, COLLECTION_PAYMENT_STATUSES, CUSTODIAL_MODES, type CashNamespace, type CollectionIntent, CollectionIntentSchema, type CollectionPayment, type CollectionPaymentResult, CollectionPaymentResultSchema, CollectionPaymentSchema, type CollectionReportSummary, CollectionReportSummarySchema, type CollectionStatement, CollectionStatementSchema, type CollectionsClient, type CollectionsClientOptions, type ConsumerCollectionsClient, type ConsumerOAC, type OACRecord as ConsumerOACRecord, OACRecordSchema as ConsumerOACRecordSchema, ConsumerOACSchema, type ConsumerPaymentClaim, ConsumerPaymentClaimSchema, type ConsumerSettleResult, ConsumerSettleResultSchema, type ConsumerSettlement, ConsumerSettlementSchema, type ConsumerWithdrawalsClient, type ConsumerWithdrawalsClientOptions, type CreateBusinessAccountInput, type CreateCollectionIntentInput, CreateCollectionIntentInputSchema, type CreatePayLinkResponse, type CreatePayoutDestinationInput, CreatePayoutDestinationInputSchema, type CreatePayoutInput, CreatePayoutInputSchema, type CreateTransferOptions, type CreateWithdrawalInput, CreateWithdrawalInputSchema, type CreateWithdrawalResult, CreateWithdrawalResultSchema, type CustodialMode, type DecodedArtifactUri, type DeviceKeyRecord, DeviceKeyRecordSchema, type DeviceTrustState, type DisableOfflineInput, DisableOfflineInputSchema, type DisableOfflineResult, DisableOfflineResultSchema, type Ed25519KeyPair, type EnableOfflineInput, EnableOfflineInputSchema, type EnableOfflineResult, EnableOfflineResultSchema, FIELD, FLUR_ARTIFACT_URI_PREFIX, FLUR_ARTIFACT_URI_SCHEME, FLUR_ARTIFACT_VERSION, FlurApiError, FlurArtifactError, FlurCapExceededError, FlurClient, type FlurClientOptions, FlurError, type FlurErrorCode, FlurExpiredError, type FlurHandle, type FlurInitOptions, type FlurOfflineSettlementsClient, type FlurPartnerClient, type FlurPaymentEvent, FlurReplayError, HARDENED_ARTIFACT_TYPES, type HmacFetchOptions, IdentityArtifactSchema, type IngestFundingResult, IngestFundingResultSchema, type IssueOACInput, IssueOACInputSchema, type IssueOfflineTokenInput, type IssuePassInput, type IssueReceiptInput, LedgerJournalEntryArtifactSchema, type ListPassesInput, type ListPassesResponse, type ListPayoutDestinationsResult, ListPayoutDestinationsResultSchema, type ListReceiptsInput, type ListReceiptsResponse, type ListTransactionsOptions, MEMBERSHIP_ROLES, MERCHANT_PAYOUT_STATUSES, MERCHANT_PROFILE_STATUSES, type MeOfflineClient, type MeOfflineClientOptions, type MembershipRole, type MerchantAccountInfo, type MerchantPayout, MerchantPayoutSchema, type MerchantProfile, MerchantProfileSchema, type MintedApiCredential, MintedApiCredentialSchema, type Money, NGN_CURRENCY_CODE, NG_COUNTRY_CODE, NQRParseError, type NQRPayloadInput, NqrPaymentRequestArtifactSchema, type OAC, OACSchema, OAC_DEFAULT_CUMULATIVE_KOBO, OAC_DEFAULT_PER_TX_KOBO, OAC_DEFAULT_VALIDITY_MS, OfflineClaimArtifactSchema, type OfflineHoldRecord, OfflineHoldRecordSchema, type OfflinePaymentAuthorization, type OfflinePaymentAuthorizationArtifact, OfflinePaymentAuthorizationArtifactSchema, OfflinePaymentAuthorizationSchema, type OfflinePaymentRequest, OfflinePaymentRequestSchema, type OfflineStateResult, OfflineStateResultSchema, type OfflineStatusResult, OfflineStatusResultSchema, type OfflineToken, OfflineTokenSchema, type OnboardingCompleteInput, type OnboardingCompleteResponse, type OnboardingFallback, type OnboardingRiskReason, type OnboardingStartInput, type OnboardingStartResponse, PARTNER_FUNDING_DIRECTIONS, PARTNER_FUNDING_STATUSES, PARTNER_KINDS, PARTNER_PROFILE_STATUSES, PARTNER_SCOPES, PASS_KINDS, PASS_STATES, PAYLOAD_FORMAT_INDICATOR_VALUE, PAYOUT_DESTINATION_STATUSES, POINT_OF_INITIATION, type ParsedNQR, type PartnerClientOptions, type PartnerCollectionsClient, type PartnerFunding, type PartnerFundingClient, type PartnerFundingDirection, type PartnerFundingEventInput, PartnerFundingEventInputSchema, PartnerFundingSchema, type PartnerFundingStatus, type PartnerKind, type PartnerProfile, type PartnerProfileAdminClient, type PartnerProfileAdminClientOptions, PartnerProfileSchema, type PartnerProfileStatus, type PartnerScope, type PartnerSignResult, type Pass, PassArtifactSchema, type PassKind, type PassMetadata, PassMetadataSchema, PassSchema, type PassState, type PassesClient, type PassesClientOptions, type PayCollectionInput, PayCollectionInputSchema, type PayCollectionOptions, type PayCollectionResponse, type PaymentClaim, PaymentClaimSchema, PaymentIntentArtifactSchema, type PayoutDestination, PayoutDestinationSchema, type PayoutDestinationStatus, type PayoutEventInput, PayoutEventInputSchema, type PinSetInput, type PinVerifyInput, type ProviderEventInput, ProviderEventInputSchema, type ProviderEventRecord, ProviderEventRecordSchema, type PublicCollectionIntent, PublicCollectionIntentSchema, type PushPlatform, type PushRegisterInput, RECEIPT_CHANNELS, RECEIPT_KINDS, REPLAY_WINDOW_MS, type Receipt, type ReceiptArtifact, ReceiptArtifactSchema, type ReceiptChannel, type ReceiptKind, type ReceiptPayload, ReceiptPayloadSchema, ReceiptSchema, type ReceiptsClient, type ReceiptsClientOptions, type RecipientResolveInput, type RecipientResolveResponse, type ReconciliationReport, ReconciliationReportSchema, type RecordPayoutEventResult, RecordPayoutEventResultSchema, type RedeemPassResponse, type Redemption, RedemptionSchema, type RegisterDeviceInput, type RegisterDeviceKeyInput, RegisterDeviceKeyInputSchema, type RegisterDeviceResponse, type RegisterSendDeviceKeyInput, type ResolveCollectionOptions, type ResolveCollectionResponse, type ResolvePayLinkResponse, ReversalRecordArtifactSchema, RevokeDeviceKeyInputSchema, type RevokePassInput, type RoutingHint, SETTLEMENT_SCHEDULES, type SendChallengeInput, type SendChallengeResponse, type SendMoneyInput, type SendMoneyOptions, type SendVerifyInput, type SendVerifyResponse, type SettleResponse, SettleResponseSchema, type Settlement, SettlementRecordArtifactSchema, SettlementSchema, type SignedArtifact, type SignedConsumerOAC, SignedConsumerOACSchema, StatementArtifactSchema, type SubscribeOptions, type TLVField, type TransactionDetailResponse, type TransactionDirection, type TransactionsListResponse, type TransferInput, type TransferResponse, type TransferStatus, type UnsignedOAC, type UnsignedOfflinePaymentAuthorization, type UnsignedOfflinePaymentRequest, type UnsignedPass, type UnsignedReceipt, type UnsignedRedemption, type UpsertMerchantProfileInput, UpsertMerchantProfileInputSchema, type UpsertPartnerProfileInput, UpsertPartnerProfileInputSchema, type VerifiedArtifact, type VerifyArtifactOptions, WITHDRAWAL_STATES, type Withdrawal, WithdrawalSchema, type WithdrawalState, base64UrlDecode, base64UrlEncode, bodySha256Hex, buildArtifactBody, buildAuthorization, buildOAC, buildPass, buildPaymentRequest, buildReceipt, buildRedemption, canonicalJSONBytes, canonicalJSONStringify, canonicalRequestString, computeEncounterId, constantTimeEqual, crc16ccitt, crc16ccittHex, createAccountsClient, createApiCredentialsAdminClient, createArtifactUri, createCollectionsClient, createConsumerCollectionsClient, createConsumerWithdrawalsClient, createFlurPartnerClient, createHmacFetch, createMeOfflineClient, createOfflinePaymentAuthorizationArtifactUri, createOfflineSettlementsClient, createPartnerCollectionsClient, createPartnerFundingClient, createPartnerProfileAdminClient, createPassesClient, createReceiptArtifactUri, createReceiptsClient, decodeArtifactUri, decodeAuthorizationQR, decodeBase45, decodePaymentRequestQR, encodeArtifactUri, encodeAuthorizationQR, encodeBase45, encodeNQR, encodePaymentRequestQR, formatAmount, generateDynamicQR, generateKeyPair, generateStaticQR, init, isHardenedArtifactType, isKnownArtifactType, isPassWithinValidity, moneyMinorToNumber, normalizeE164, parseAmountInput, parseNQR, parseQR, publicKeyFromPrivate, readTLV, routingHint, sign, signArtifact, signAuthorization, signCanonical, signOAC, signPartnerRequest, signPass, signPaymentRequest, signReceipt, signRedemption, signRequestHMAC, verify, verifyArtifactSignature, verifyArtifactUri, verifyAuthorization, verifyCanonical, verifyOAC, verifyPass, verifyPaymentRequest, verifyReceipt, verifyRedemption, verifyRequestHMAC, writeTLV };