Skip to main content

Doc Sync Agent Instructions

This repo contains documentation for Spark (https://spark.money).

Repo Structure

issuance/           # Token issuance tutorials (IssuerSparkWallet)
wallets/            # Wallet tutorials (SparkWallet)
api-reference/
  wallet/           # SparkWallet method reference
  issuer/           # IssuerSparkWallet method reference
learn/              # Conceptual docs (architecture, trust model)
quickstart/         # Getting started guides

SDK Source of Truth

The Spark SDKs are the source of truth:
  • SparkWallet: sdks/js/packages/spark-sdk/src/spark-wallet/spark-wallet.ts
  • IssuerSparkWallet: sdks/js/packages/issuer-sdk/src/issuer-wallet/issuer-spark-wallet.ts

Sync Rules

Method Signatures

  • Parameter names must match SDK EXACTLY
  • Types must match EXACTLY (bigint vs number matters)
  • Optional parameters must be marked correctly
  • Return types must match

Deprecations

  • Methods marked @deprecated in SDK need <Warning>**Deprecated**...</Warning> in docs
  • Link to the replacement method

Code Examples

  • Must use correct parameter syntax
  • Object-style params: method({ param1, param2 })
  • Positional params: method(param1, param2)

Common Issues to Check

  1. Multi-token support - IssuerSparkWallet methods now take tokenIdentifier parameter
  2. Object vs positional params - Many methods changed from positional to object params
  3. Async/await - Ensure examples have await for async methods
  4. Type accuracy - bigint for token amounts, number for sats

Files to Compare

When syncing, always compare:
Doc FileSDK Source
api-reference/wallet/*.mdxspark-wallet.ts
api-reference/issuer/*.mdxissuer-spark-wallet.ts
issuance/*.mdxissuer-spark-wallet.ts
wallets/*.mdxspark-wallet.ts