Skip to content

TrackedPayment

SIP Protocol API Reference v0.7.0


SIP Protocol API Reference / TrackedPayment

Defined in: @sip-protocol/types/dist/index.d.ts:1549

Payment tracking info

paymentId: string

Defined in: @sip-protocol/types/dist/index.d.ts:1449

Unique payment identifier

ShieldedPayment.paymentId


version: string

Defined in: @sip-protocol/types/dist/index.d.ts:1451

SIP version

ShieldedPayment.version


privacyLevel: PrivacyLevel

Defined in: @sip-protocol/types/dist/index.d.ts:1453

Privacy level for this payment

ShieldedPayment.privacyLevel


createdAt: number

Defined in: @sip-protocol/types/dist/index.d.ts:1455

Creation timestamp (Unix seconds)

ShieldedPayment.createdAt


expiry: number

Defined in: @sip-protocol/types/dist/index.d.ts:1457

Expiration timestamp (Unix seconds)

ShieldedPayment.expiry


token: Asset

Defined in: @sip-protocol/types/dist/index.d.ts:1459

The token being transferred

ShieldedPayment.token


amount: bigint

Defined in: @sip-protocol/types/dist/index.d.ts:1461

Amount in smallest units (hidden via commitment in shielded mode)

ShieldedPayment.amount


optional amountCommitment: Commitment

Defined in: @sip-protocol/types/dist/index.d.ts:1463

Pedersen commitment to amount (for shielded mode)

ShieldedPayment.amountCommitment


optional senderCommitment: Commitment

Defined in: @sip-protocol/types/dist/index.d.ts:1465

Pedersen commitment to sender (for shielded mode)

ShieldedPayment.senderCommitment


optional recipientStealth: object

Defined in: @sip-protocol/types/dist/index.d.ts:1467

Recipient stealth address (for shielded mode)

address: `0x${string}`

ephemeralPublicKey: `0x${string}`

viewTag: number

ShieldedPayment.recipientStealth


optional recipientAddress: string

Defined in: @sip-protocol/types/dist/index.d.ts:1473

Direct recipient address (for transparent mode)

ShieldedPayment.recipientAddress


sourceChain: ChainId

Defined in: @sip-protocol/types/dist/index.d.ts:1475

Source chain

ShieldedPayment.sourceChain


destinationChain: ChainId

Defined in: @sip-protocol/types/dist/index.d.ts:1477

Destination chain (can be same as source for same-chain transfers)

ShieldedPayment.destinationChain


optional purpose: PaymentPurpose

Defined in: @sip-protocol/types/dist/index.d.ts:1479

Payment purpose (for compliance)

ShieldedPayment.purpose


optional memo: string

Defined in: @sip-protocol/types/dist/index.d.ts:1481

Optional memo/reference (encrypted in shielded mode)

ShieldedPayment.memo


optional encryptedMemo: `0x${string}`

Defined in: @sip-protocol/types/dist/index.d.ts:1483

Encrypted memo (for shielded mode with viewing key)

ShieldedPayment.encryptedMemo


optional fundingProof: ZKProof

Defined in: @sip-protocol/types/dist/index.d.ts:1485

Funding proof (balance >= amount)

ShieldedPayment.fundingProof


optional authorizationProof: ZKProof

Defined in: @sip-protocol/types/dist/index.d.ts:1487

Authorization proof

ShieldedPayment.authorizationProof


optional viewingKeyHash: `0x${string}`

Defined in: @sip-protocol/types/dist/index.d.ts:1489

Viewing key hash (for compliant mode)

ShieldedPayment.viewingKeyHash


status: PaymentStatusType

Defined in: @sip-protocol/types/dist/index.d.ts:1551

Current status


optional sourceTxHash: string

Defined in: @sip-protocol/types/dist/index.d.ts:1553

Source transaction hash (once submitted)


optional destinationTxHash: string

Defined in: @sip-protocol/types/dist/index.d.ts:1555

Destination transaction hash (once settled)


optional error: string

Defined in: @sip-protocol/types/dist/index.d.ts:1557

Error message (if failed)