chore: wip

Author: glennmichael123

CHANGELOG.md

@@ -100,7 +100,6 @@
 
 ## ...main
 
-
 ### 📖 Documentation
 
 - Several minor updates ([877a7d2](https://github.com/stacksjs/qrx/commit/877a7d2))
@@ -118,4 +117,3 @@
 ### ❤️ Contributors
 
 - Chris ([@chrisbbreuer](http://github.com/chrisbbreuer))
-

README.md

@@ -160,7 +160,7 @@ export default defineConfig({
 - [CLI Reference](https://ts-tokens.dev/cli)
 - [API Reference](https://ts-tokens.dev/api)
 
-## Why ts-tokens?
+## Why ts-tokens
 
 **Zero External Dependencies**: Unlike Metaplex SDKs, ts-tokens only depends on official Solana packages (`@solana/web3.js`, `@solana/spl-token`). We implement all program interactions using raw instructions.
 

TODO.md

@@ -153,7 +153,7 @@ const progress = {
   total: Number(cm.itemsAvailable),
   minted: Number(cm.itemsRedeemed),
   remaining: Number(cm.itemsAvailable - cm.itemsRedeemed),
-  percentage: Number((cm.itemsRedeemed * 100n) / cm.itemsAvailable),
+  percentage: Number((cm.itemsRedeemed _ 100n) / cm.itemsAvailable),
 }
 
 console.log(`Progress: ${progress.minted}/${progress.total} (${progress.percentage}%)`)
@@ -166,7 +166,7 @@ const cm = await getCandyMachine(address, config)
 const price = 1_000_000_000n // 1 SOL
 
 const revenue = {
-  total: Number(cm.itemsRedeemed) * Number(price) / 1e9,
+  total: Number(cm.itemsRedeemed) _ Number(price) / 1e9,
   currency: 'SOL',
 }
 

docs/api/candy-machine/manage.md

@@ -25,8 +25,8 @@ const pool = await createStakingPool({
   stakeMint: tokenMint,
   rewardMint: rewardTokenMint,
   rewardRate: 1_000_000n, // rewards per second
-  rewardDuration: 30n * 24n * 60n * 60n, // 30 days
-  minStakeDuration: 7n * 24n * 60n * 60n, // 7 day lock
+  rewardDuration: 30n _ 24n _ 60n _ 60n, // 30 days
+  minStakeDuration: 7n _ 24n _ 60n _ 60n, // 7 day lock
   earlyUnstakePenalty: 1000, // 10% penalty
 }, config)
 ```
@@ -41,7 +41,7 @@ const config = await getConfig()
 await stake({
   pool: poolAddress,
   amount: 1000_000_000_000n, // 1000 tokens
-  lockDuration: 30n * 24n * 60n * 60n, // 30 days
+  lockDuration: 30n _ 24n _ 60n _ 60n, // 30 days
 }, config)
 ```
 
@@ -121,7 +121,7 @@ const config = await getConfig()
 const info = await getNFTStakeInfo(stakeAccount, config)
 
 console.log('Points earned:', info.pointsEarned)
-console.log('Staked at:', new Date(Number(info.stakedAt) * 1000))
+console.log('Staked at:', new Date(Number(info.stakedAt) _ 1000))
 ```
 
 ### Unstake NFT
@@ -184,18 +184,18 @@ Rewards are calculated using a checkpoint system:
 
 ```
 rewardPerToken = rewardPerTokenStored + (
-  (currentTime - lastUpdateTime) * rewardRate / totalStaked
+  (currentTime - lastUpdateTime) _ rewardRate / totalStaked
 )
 
-earned = (stakedAmount * (rewardPerToken - userRewardPerTokenPaid)) + rewardsEarned
+earned = (stakedAmount _ (rewardPerToken - userRewardPerTokenPaid)) + rewardsEarned
 ```
 
 ## Early Unstake Penalty
 
 If unstaking before lock period ends:
 
 ```
-penalty = amount * (remainingLockTime / totalLockTime) * penaltyBps / 10000
+penalty = amount _ (remainingLockTime / totalLockTime) _ penaltyBps / 10000
 ```
 
 ## Related

docs/api/staking/index.md

@@ -2,7 +2,7 @@
 
 Add and manage metadata for fungible tokens.
 
-## Why Token Metadata?
+## Why Token Metadata
 
 Metadata allows tokens to display properly in wallets and explorers:
 

docs/api/tokens/metadata.md

@@ -150,21 +150,26 @@ ts-tokens/
 ## Design Principles
 
 1. **Zero SDK Dependencies** -- All on-chain program interactions use raw
+
    `TransactionInstruction` builders from `@solana/web3.js`. No Metaplex,
    Serum, or other external SDKs are included.
 
 2. **Driver Abstraction** -- The `ChainDriver` interface in `types/driver.ts`
+
    defines a chain-agnostic API. Currently only Solana is implemented, but
    the registry pattern supports future chains.
 
 3. **Storage Adapter Pattern** -- All storage providers implement the
+
    `StorageAdapter` interface. A factory function auto-selects the adapter
    from config, and a fallback chain tries providers in order.
 
 4. **Layered Architecture** -- Types and config sit at the bottom, programs
+
    and drivers in the middle, high-level modules on top, and fluent/CLI at
    the surface. Dependencies flow downward only.
 
 5. **Barrel Exports** -- Each module has an `index.ts` that re-exports its
+
    public API. The top-level `src/index.ts` re-exports everything for
    consumers who want a single import path.

docs/architecture.md

@@ -74,7 +74,9 @@ NFT Info:
   Collection: DEF456...
   Royalty: 5%
   Creators:
+
     - ABC123... (100%)
+
 ```
 
 ## `tokens nft:list`
@@ -90,9 +92,11 @@ tokens nft:list --owner <address>
 
 ```text
 NFTs (3 total):
+
   1. Cool NFT #1 (ABC123...)
   2. Cool NFT #2 (DEF456...)
   3. Rare Item (GHI789...)
+
 ```
 
 ## `tokens collection:create`

docs/cli/nft.md

@@ -10,86 +10,126 @@ import path from 'node:path'
 
 const config: tokensConfig = {
   /**
-   * The type of the QR code.
-   */
+
+   _ The type of the QR code.
+
+   _/
   type: 'qr', // 'qr' | 'bar'
 
   options: {
     /**
-     * The width of the QR code.
-     */
+
+     _ The width of the QR code.
+
+     _/
     width: 2,
     /**
-     * The height of the QR code.
-     */
+
+     _ The height of the QR code.
+
+     _/
     height: 100,
     /**
-     * The format of the QR code.
-     */
+
+     _ The format of the QR code.
+
+     _/
     format: 'auto',
     /**
-     * Whether to display the value in the QR code.
-     */
+
+     _ Whether to display the value in the QR code.
+
+     _/
     displayValue: true,
     /**
-     * The font options for the QR code.
-     */
+
+     _ The font options for the QR code.
+
+     _/
     fontOptions: '',
     /**
-     * The font for the QR code.
-     */
+
+     _ The font for the QR code.
+
+     _/
     font: 'monospace',
     /**
-     * The text for the QR code.
-     */
+
+     _ The text for the QR code.
+
+     _/
     text: undefined,
     /**
-     * The text alignment for the QR code.
-     */
+
+     _ The text alignment for the QR code.
+
+     _/
     textAlign: 'center', // 'left' | 'center' | 'right'
     /**
-     * The text position for the QR code.
-     */
+
+     _ The text position for the QR code.
+
+     _/
     textPosition: 'bottom', // 'top' | 'bottom' | 'left' | 'right'
     /**
-     * The text margin for the QR code.
-     */
+
+     _ The text margin for the QR code.
+
+     _/
     textMargin: 2,
     /**
-     * The font size for the QR code.
-     */
+
+     _ The font size for the QR code.
+
+     _/
     fontSize: 20,
     /**
-     * The background color for the QR code.
-     */
+
+     _ The background color for the QR code.
+
+     _/
     background: '#ffffff',
     /**
-     * The line color for the QR code.
-     */
+
+     _ The line color for the QR code.
+
+     _/
     lineColor: '#000000',
     /**
-     * The margin for the QR code.
-     */
+
+     _ The margin for the QR code.
+
+     _/
     margin: 10,
     /**
-     * The margin top for the QR code.
-     */
+
+     _ The margin top for the QR code.
+
+     _/
     marginTop: undefined,
     /**
-     * The margin right for the QR code.
-     */
+
+     _ The margin right for the QR code.
+
+     _/
     marginBottom: undefined,
     /**
-     * The margin left for the QR code.
-     */
+
+     _ The margin left for the QR code.
+
+     _/
     marginLeft: undefined,
     /**
-     * The margin right for the QR code.
-     */
+
+     _ The margin right for the QR code.
+
+     _/
     marginRight: undefined,
     /**
-     * The error correction level for the QR code.
-     */
+
+     _ The error correction level for the QR code.
+
+     _/
     valid() { },
   },
 }

docs/config.md

@@ -15,13 +15,15 @@
 ### 1. No Global Instance
 
 Metaplex SDK uses a global instance pattern:
+
 ```typescript
 // Metaplex SDK
 const metaplex = Metaplex.make(connection).use(keypairIdentity(wallet))
 const nft = await metaplex.nfts().findByMint(...)
 ```
 
 ts-tokens passes config to each function:
+
 ```typescript
 // ts-tokens
 const config = { rpcUrl, keypair }
@@ -31,6 +33,7 @@ const nft = await getNFTMetadata(mint, config)
 ### 2. String Addresses
 
 Metaplex SDK requires `PublicKey` objects everywhere. ts-tokens accepts plain strings:
+
 ```typescript
 // Metaplex SDK
 const mint = new PublicKey('...')
@@ -43,13 +46,15 @@ await getNFTMetadata('...', config)
 ### 3. Built-in Batch Operations
 
 ts-tokens includes native batch support:
+
 ```typescript
 import { batchUpdateNFTMetadata, batchVerifyCollection, batchBurnNFTs } from 'ts-tokens/legacy'
 ```
 
 ### 4. DAS API Integration
 
 ts-tokens can use DAS API for faster queries:
+
 ```typescript
 import { getNFTsInCollection } from 'ts-tokens/legacy'
 // Automatically uses DAS when available, falls back to on-chain
@@ -59,6 +64,7 @@ const nfts = await getNFTsInCollection(collection, config, { useDAS: true })
 ### 5. Collection Discovery
 
 ts-tokens adds discovery capabilities not in Metaplex SDK:
+
 ```typescript
 import { discoverCollectionByCreator, discoverCollectionByCandyMachine } from 'ts-tokens/legacy'
 ```