@pbgtoken/rwa-contract 1.0.2 → 1.0.3

package/dist/index.js

@@ -171,7 +171,7 @@ import { makeCast, makeUserFunc } from "@helios-lang/contract-utils";
 var tokenized_account = {
   $name: "tokenized_account",
   $purpose: "mixed",
-  $currentScriptIndex: 0,
+  $currentScriptIndex: 1,
   $sourceCode: `mixed tokenized_account
 
 import { get_current_input, tx } from ScriptContext
@@ -421,7 +421,230 @@ func main(args: MixedArgs) -> () {
     "main": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "main", "arguments": [{ "name": "$datum", "isOptional": true, "type": { "kind": "internal", "name": "Data" } }, { "name": "args", "isOptional": false, "type": { "kind": "enum", "id": "__helios__mixedargs", "name": "MixedArgs", "variantTypes": [{ "kind": "variant", "name": "Other", "id": "__helios__mixedargs__other", "tag": 0, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }, { "kind": "variant", "name": "Spending", "id": "__helios__mixedargs__spending", "tag": 1, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }] } }], "requiresCurrentScript": false, "requiresScriptContext": true }, castConfig: config, validatorIndices: __validatorIndices })
   }
 };
-var __validatorIndices = { "tokenized_account": 0 };
+var one_to_one_asset = {
+  $name: "one_to_one_asset",
+  $purpose: "mixed",
+  $currentScriptIndex: 0,
+  $sourceCode: `mixed one_to_one_asset
+
+import { get_current_input, tx } from ScriptContext
+
+struct State {
+    supply:             Int       "supply"
+
+    type:        String    "type"    // eg. Bitcoin or ERC20
+    account:     ByteArray "account" // if type==Private -> this is a hash of the actual account type + address
+
+    name:        String "name"
+    description: String "description"
+    decimals:    Int    "decimals"    // can't change
+    ticker:      String "ticker"      // can't change
+    url:         String "url"
+    logo:        String "logo"
+}
+
+enum Cip68Extra {
+    Unused
+}
+
+enum Metadata {
+    Cip68 {
+        state:   State
+        version: Int
+        extra:   Cip68Extra
+    }
+
+    func state(self) -> State {
+        self.switch{
+            x: Cip68 => x.state
+        }
+    }
+}
+
+struct Redeemer {
+    reserves: Int
+}
+
+const SEED_ID          = TxOutputId::new(TxId::new(#), 0)
+const ORACLE_KEYS      = []PubKeyHash{}
+const INITIAL_PRICE: Real = 0.001 // 1000 USD per token -> 0.001 USD per microtoken
+const TYPE             = "Bitcoin"
+const ACCOUNT          = #
+const TICKER           = "BTC"
+const NAME             = "wrapped " + TICKER
+const DESCRIPTION      = "wrapped" + TICKER + " operated by PBG"
+const DECIMALS         = 6
+const URL              = "https://www.pbg.io"
+const LOGO             = "https://assets.pbg.io/usdt_bridge.png"
+
+const ticker_bytes    = TICKER.encode_utf8()
+const user_token_name = Cip67::fungible_token_label + ticker_bytes
+const ref_token_name  = Cip67::reference_token_label + ticker_bytes
+
+const own_hash    = Scripts::tokenized_account
+const own_mph     = MintingPolicyHash::from_script_hash(own_hash)
+const own_address = Address::new(
+    SpendingCredential::new_validator(
+        ValidatorHash::from_script_hash(own_hash)
+    ),
+    Option[StakingCredential]::None
+)
+
+const ref_token_asset_class  = AssetClass::new(own_mph, ref_token_name)
+const user_token_asset_class = AssetClass::new(own_mph, user_token_name)
+
+func validate_initialization() -> () {
+    assert(tx.inputs.any((input: TxInput) -> {
+        input.output_id == SEED_ID
+    }), "seed UTXO not spent")
+
+    ref_utxo = tx.outputs.find((output: TxOutput) -> {
+        output.address == own_address
+        && output.value.get_safe(ref_token_asset_class) == 1
+    })
+
+    metadata = ref_utxo.datum.inline.as_strictly[Metadata]
+
+    assert(metadata == Metadata::Cip68{
+        State{
+            supply:  0,
+            type:    TYPE,
+            account: ACCOUNT,
+
+            name:        NAME,
+            description: DESCRIPTION,
+            decimals:    DECIMALS,
+            ticker:      TICKER,
+            url:         URL,
+            logo:        LOGO
+        },
+        1,
+        Cip68Extra::Unused
+    }, "metadata not initialized correctly")
+}
+
+func signed_by_quorum() -> Bool {
+    n_signers = ORACLE_KEYS.fold((n_signers: Int, key: PubKeyHash) -> {
+        n_signers + tx.is_signed_by(key).to_int()
+    }, 0)
+
+    n_signers > (ORACLE_KEYS.length/2)
+}
+
+func validate_state_change(redeemer: Redeemer, input: TxInput) -> () {
+    state0 = input.datum.inline.as[Metadata].state()
+
+    output = tx.outputs.find((output: TxOutput) -> {
+        output.address == own_address
+        && output.value.get_safe(ref_token_asset_class) > 0
+    })
+
+    state1 = output.datum.inline.as_strictly[Metadata].state()
+
+    // ensure constant metadata fields don't change
+    assert(state1.type == state0.type, "type not constant")
+    assert(state1.account == state0.account, "account not constant")
+    assert(state1.ticker == state0.ticker, "metadata ticker not constant")
+    assert(state1.decimals == state0.decimals, "metadata decimals not constant")
+
+    n = tx.minted.get_safe(user_token_asset_class)
+    N0 = state0.supply
+    N1 = state1.supply
+
+    assert((N1 - N0) == n, "current token supply not updated correctly")
+
+    if (n > 0) {
+        Redeemer{R} = redeemer
+
+        assert(N1 <= R, "too many tokens minted")
+        assert(signed_by_quorum(), "not signed by simple quorum of oracles")
+    }
+}
+
+func main(args: MixedArgs) -> () {
+    args.switch{
+        s: Spending => {
+            redeemer = s.redeemer.as[Redeemer]
+
+            utxo = get_current_input()
+
+            tokens = utxo.value.get_policy(own_mph)
+
+            if (tokens.is_empty()) {
+                // UTXOs that don't contain any tokens from current policy can always be spent.
+                // This can be used to remove garbage.
+                ()
+            } else {
+                (name, _) = tokens.head
+
+                if (name == ref_token_name) {
+                    validate_state_change(redeemer, utxo)
+                } else {
+                    error("unexpected token name")
+                }
+            }
+        },
+        Other => {
+            tokens = tx.minted.get_policy(own_mph)
+
+            (name, qty) = tokens.head
+            tail = tokens.tail
+
+            assert(tail.is_empty(), "only one token kind can be minted or burned")
+
+            if (name == user_token_name && qty != 0) {
+                // metadata token must be spent, which triggers Spending witness
+                assert(tx.inputs.any((input: TxInput) -> {
+                    input.address == own_address
+                    && input.value.get_safe(ref_token_asset_class) > 0
+                }), "ref token not spent")
+            } else if (qty == 1 && (name == ref_token_name)) {
+                validate_initialization()
+            } else {
+                error("invalid minted tokens")
+            }
+        }
+    }
+}`,
+  $dependencies: [],
+  $hashDependencies: [tokenized_account],
+  $dependsOnOwnHash: false,
+  $Redeemer: (config) => makeCast({ "kind": "enum", "id": "__helios__mixedargs", "name": "MixedArgs", "variantTypes": [{ "kind": "variant", "name": "Other", "id": "__helios__mixedargs__other", "tag": 0, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }, { "kind": "variant", "name": "Spending", "id": "__helios__mixedargs__spending", "tag": 1, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }] }, config),
+  $Datum: (config) => makeCast({ "kind": "internal", "name": "Data" }, config),
+  $types: {
+    State: (config) => makeCast({ "kind": "struct", "format": "map", "id": "__module__one_to_one_asset__State[]", "name": "State", "fieldTypes": [{ "name": "supply", "type": { "kind": "internal", "name": "Int" }, "key": "supply" }, { "name": "type", "type": { "kind": "internal", "name": "String" }, "key": "type" }, { "name": "account", "type": { "kind": "internal", "name": "ByteArray" }, "key": "account" }, { "name": "name", "type": { "kind": "internal", "name": "String" }, "key": "name" }, { "name": "description", "type": { "kind": "internal", "name": "String" }, "key": "description" }, { "name": "decimals", "type": { "kind": "internal", "name": "Int" }, "key": "decimals" }, { "name": "ticker", "type": { "kind": "internal", "name": "String" }, "key": "ticker" }, { "name": "url", "type": { "kind": "internal", "name": "String" }, "key": "url" }, { "name": "logo", "type": { "kind": "internal", "name": "String" }, "key": "logo" }] }, config),
+    Cip68Extra: (config) => makeCast({ "kind": "enum", "name": "Cip68Extra", "id": "__module__one_to_one_asset__Cip68Extra[]", "variantTypes": [{ "kind": "variant", "tag": 0, "id": "__module__one_to_one_asset__Cip68Extra[]__Unused", "name": "Unused", "fieldTypes": [] }] }, config),
+    Metadata: (config) => makeCast({ "kind": "enum", "name": "Metadata", "id": "__module__one_to_one_asset__Metadata[]", "variantTypes": [{ "kind": "variant", "tag": 0, "id": "__module__one_to_one_asset__Metadata[]__Cip68", "name": "Cip68", "fieldTypes": [{ "name": "state", "type": { "kind": "struct", "format": "map", "id": "__module__one_to_one_asset__State[]", "name": "State", "fieldTypes": [{ "name": "supply", "type": { "kind": "internal", "name": "Int" }, "key": "supply" }, { "name": "type", "type": { "kind": "internal", "name": "String" }, "key": "type" }, { "name": "account", "type": { "kind": "internal", "name": "ByteArray" }, "key": "account" }, { "name": "name", "type": { "kind": "internal", "name": "String" }, "key": "name" }, { "name": "description", "type": { "kind": "internal", "name": "String" }, "key": "description" }, { "name": "decimals", "type": { "kind": "internal", "name": "Int" }, "key": "decimals" }, { "name": "ticker", "type": { "kind": "internal", "name": "String" }, "key": "ticker" }, { "name": "url", "type": { "kind": "internal", "name": "String" }, "key": "url" }, { "name": "logo", "type": { "kind": "internal", "name": "String" }, "key": "logo" }] } }, { "name": "version", "type": { "kind": "internal", "name": "Int" } }, { "name": "extra", "type": { "kind": "enum", "name": "Cip68Extra", "id": "__module__one_to_one_asset__Cip68Extra[]", "variantTypes": [{ "kind": "variant", "tag": 0, "id": "__module__one_to_one_asset__Cip68Extra[]__Unused", "name": "Unused", "fieldTypes": [] }] } }] }] }, config),
+    Redeemer: (config) => makeCast({ "kind": "struct", "format": "singleton", "id": "__module__one_to_one_asset__Redeemer[]", "name": "Redeemer", "fieldTypes": [{ "name": "reserves", "type": { "kind": "internal", "name": "Int" } }] }, config)
+  },
+  $functions: {
+    "Metadata::state": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "Metadata::state", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [{ "name": "self", "isOptional": false, "type": { "kind": "enum", "name": "Metadata", "id": "__module__one_to_one_asset__Metadata[]", "variantTypes": [{ "kind": "variant", "tag": 0, "id": "__module__one_to_one_asset__Metadata[]__Cip68", "name": "Cip68", "fieldTypes": [{ "name": "state", "type": { "kind": "struct", "format": "map", "id": "__module__one_to_one_asset__State[]", "name": "State", "fieldTypes": [{ "name": "supply", "type": { "kind": "internal", "name": "Int" }, "key": "supply" }, { "name": "type", "type": { "kind": "internal", "name": "String" }, "key": "type" }, { "name": "account", "type": { "kind": "internal", "name": "ByteArray" }, "key": "account" }, { "name": "name", "type": { "kind": "internal", "name": "String" }, "key": "name" }, { "name": "description", "type": { "kind": "internal", "name": "String" }, "key": "description" }, { "name": "decimals", "type": { "kind": "internal", "name": "Int" }, "key": "decimals" }, { "name": "ticker", "type": { "kind": "internal", "name": "String" }, "key": "ticker" }, { "name": "url", "type": { "kind": "internal", "name": "String" }, "key": "url" }, { "name": "logo", "type": { "kind": "internal", "name": "String" }, "key": "logo" }] } }, { "name": "version", "type": { "kind": "internal", "name": "Int" } }, { "name": "extra", "type": { "kind": "enum", "name": "Cip68Extra", "id": "__module__one_to_one_asset__Cip68Extra[]", "variantTypes": [{ "kind": "variant", "tag": 0, "id": "__module__one_to_one_asset__Cip68Extra[]__Unused", "name": "Unused", "fieldTypes": [] }] } }] }] } }], "returns": { "kind": "struct", "format": "map", "id": "__module__one_to_one_asset__State[]", "name": "State", "fieldTypes": [{ "name": "supply", "type": { "kind": "internal", "name": "Int" }, "key": "supply" }, { "name": "type", "type": { "kind": "internal", "name": "String" }, "key": "type" }, { "name": "account", "type": { "kind": "internal", "name": "ByteArray" }, "key": "account" }, { "name": "name", "type": { "kind": "internal", "name": "String" }, "key": "name" }, { "name": "description", "type": { "kind": "internal", "name": "String" }, "key": "description" }, { "name": "decimals", "type": { "kind": "internal", "name": "Int" }, "key": "decimals" }, { "name": "ticker", "type": { "kind": "internal", "name": "String" }, "key": "ticker" }, { "name": "url", "type": { "kind": "internal", "name": "String" }, "key": "url" }, { "name": "logo", "type": { "kind": "internal", "name": "String" }, "key": "logo" }] } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "SEED_ID": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "SEED_ID", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "TxOutputId" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "ORACLE_KEYS": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "ORACLE_KEYS", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "list", "itemType": { "kind": "internal", "name": "PubKeyHash" } } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "INITIAL_PRICE": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "INITIAL_PRICE", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "Real" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "TYPE": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "TYPE", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "ACCOUNT": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "ACCOUNT", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "ByteArray" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "TICKER": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "TICKER", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "NAME": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "NAME", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "DESCRIPTION": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "DESCRIPTION", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "DECIMALS": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "DECIMALS", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "Int" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "URL": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "URL", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "LOGO": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "LOGO", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "String" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "ticker_bytes": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "ticker_bytes", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "ByteArray" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "user_token_name": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "user_token_name", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "ByteArray" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "ref_token_name": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "ref_token_name", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "ByteArray" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "own_hash": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "own_hash", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "ScriptHash" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "own_mph": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "own_mph", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "MintingPolicyHash" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "own_address": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "own_address", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "Address" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "ref_token_asset_class": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "ref_token_asset_class", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "AssetClass" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "user_token_asset_class": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "user_token_asset_class", "requiresCurrentScript": false, "requiresScriptContext": false, "arguments": [], "returns": { "kind": "internal", "name": "AssetClass" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "validate_initialization": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "validate_initialization", "requiresCurrentScript": false, "requiresScriptContext": true, "arguments": [] }, castConfig: config, validatorIndices: __validatorIndices }),
+    "signed_by_quorum": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "signed_by_quorum", "requiresCurrentScript": false, "requiresScriptContext": true, "arguments": [], "returns": { "kind": "internal", "name": "Bool" } }, castConfig: config, validatorIndices: __validatorIndices }),
+    "validate_state_change": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "validate_state_change", "requiresCurrentScript": false, "requiresScriptContext": true, "arguments": [{ "name": "redeemer", "isOptional": false, "type": { "kind": "struct", "format": "singleton", "id": "__module__one_to_one_asset__Redeemer[]", "name": "Redeemer", "fieldTypes": [{ "name": "reserves", "type": { "kind": "internal", "name": "Int" } }] } }, { "name": "input", "isOptional": false, "type": { "kind": "internal", "name": "TxInput" } }] }, castConfig: config, validatorIndices: __validatorIndices }),
+    "main": (uplc, config) => makeUserFunc(uplc, { ...{ "name": "main", "arguments": [{ "name": "$datum", "isOptional": true, "type": { "kind": "internal", "name": "Data" } }, { "name": "args", "isOptional": false, "type": { "kind": "enum", "id": "__helios__mixedargs", "name": "MixedArgs", "variantTypes": [{ "kind": "variant", "name": "Other", "id": "__helios__mixedargs__other", "tag": 0, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }, { "kind": "variant", "name": "Spending", "id": "__helios__mixedargs__spending", "tag": 1, "fieldTypes": [{ "name": "redeemer", "type": { "kind": "internal", "name": "Data" } }] }] } }], "requiresCurrentScript": false, "requiresScriptContext": true }, castConfig: config, validatorIndices: __validatorIndices })
+  }
+};
+var __validatorIndices = { "one_to_one_asset": 0, "tokenized_account": 1 };
 
 // src/RWADatumProvider.ts
 var castMetadata = tokenized_account.$types.Metadata;
@@ -466,9 +689,648 @@ function filterTransfersAfter(transfers, after) {
     return transfers;
   }
 }
+
+// src/CoinGeckoProvider.ts
+var CoinGeckoProvider = class {
+  /**
+   * Get spot price for any token by CoinGecko asset ID.
+   *
+   * @param asset CoinGecko asset ID (e.g., "ethereum").
+   * @param currency Fiat or crypto currency symbol for price (default: "usd").
+   * @returns Spot price as a number, or 0 if not found.
+   */
+  async getSpotPrice(asset, currency = "usd") {
+    const url = "https://api.coingecko.com/api/v3/simple/price";
+    const params = new URLSearchParams({
+      ids: asset,
+      vs_currencies: currency.toLowerCase()
+    });
+    const response = await fetch(`${url}?${params.toString()}`);
+    const data = await response.json();
+    return data[asset]?.[currency.toLowerCase()] ?? 0;
+  }
+  /**
+   * Get spot prices for multiple tokens by their CoinGecko asset symbols.
+   *
+   * @param symbols Array of CoinGecko asset symbols (e.g., ["btc", "eth"]).
+   * @param currency Fiat or crypto currency symbol for price (default: "usd").
+   * @returns An object mapping each asset ID to its price data, or empty object if not found.
+   */
+  async getSpotPriceBySymbols(symbols, currency = "usd") {
+    const url = "https://api.coingecko.com/api/v3/simple/price";
+    const params = new URLSearchParams({
+      symbols: symbols.join(",").toLowerCase(),
+      vs_currencies: currency.toLowerCase()
+    });
+    const response = await fetch(`${url}?${params.toString()}`);
+    return await response.json();
+  }
+  /**
+   * Get spot price for a token by contract address and chain.
+   * 
+   * @param contract The token contract address.
+   * @param chain The blockchain network ("ethereum", "binance-smart-chain", etc).
+   * @param currency Fiat or crypto currency symbol for price (default: "usd").
+   * @returns Spot price as a number, or 0 if not found.
+   */
+  async getSpotPriceByTokenAddress(contract, chain = "ethereum", currency = "usd") {
+    const url = `https://api.coingecko.com/api/v3/simple/token_price/${chain}`;
+    const params = new URLSearchParams({
+      contract_addresses: contract,
+      vs_currencies: currency.toLowerCase()
+    });
+    const response = await fetch(`${url}?${params.toString()}`);
+    const data = await response.json();
+    return data[contract]?.[currency.toLowerCase()] ?? 0;
+  }
+};
+function makeCoinGeckoProvider() {
+  return new CoinGeckoProvider();
+}
+
+// src/BitcoinWalletProvider.ts
+var BitcoinWalletProviderImpl = class {
+  /**
+   * @param walletAddress The Bitcoin wallet address to query.
+   * @param priceProvider CoinGecko Price Provider
+   */
+  constructor(walletAddress, priceProvider) {
+    this.walletAddress = walletAddress;
+    this.priceProvider = priceProvider;
+  }
+  /**
+   * Calculates the net USD value of Bitcoin transactions for the given transfer IDs.
+   * 
+   * - Adds value from outputs (vout) sent **to** the wallet.
+   * - Subtracts value from inputs (vin.prevout) **from** the wallet.
+   * 
+   * Converts net BTC to USD using the current spot price.
+   *
+   * @param transfers Array of Bitcoin transaction hashes (TransferID[])
+   * @returns Net deposit amount in USD.
+   */
+  async deposits(transfers) {
+    const url = `https://blockstream.info/api/address/${this.walletAddress}/txs`;
+    const res = await fetch(url);
+    const txs = await res.json();
+    const depositTxIDs = new Set(transfers);
+    let totalDepositedBTC = 0;
+    for (const tx of txs) {
+      if (!depositTxIDs.has(tx.txid)) continue;
+      for (const vout of tx.vout) {
+        if (vout.scriptpubkey_address === this.walletAddress && typeof vout.value === "number") {
+          totalDepositedBTC += vout.value / 1e8;
+        }
+      }
+      for (const vin of tx.vin) {
+        if (vin.prevout?.scriptpubkey_address === this.walletAddress && typeof vin.prevout.value === "number") {
+          totalDepositedBTC -= vin.prevout.value / 1e8;
+        }
+      }
+    }
+    const price = await this.priceProvider.getSpotPrice("bitcoin", "usd");
+    return totalDepositedBTC * price;
+  }
+  /**
+   * Returns the balance of the wallet in BTC.
+   */
+  get balance() {
+    return this.getBalance();
+  }
+  /**
+   * Returns the USD value of the wallet's balance for native BTC.
+   */
+  get usdBalance() {
+    return this.getUSDValue();
+  }
+  /**
+   * Returns the transfer history for the wallet.
+   */
+  get transferHistory() {
+    return this.getTransferHistory();
+  }
+  /**
+   * Fetches the BTC balance for the wallet using Blockstream public API.
+   */
+  async getBalance() {
+    return await this.getSats() / 1e8;
+  }
+  async getSats() {
+    const url = `https://blockstream.info/api/address/${this.walletAddress}`;
+    const res = await fetch(url);
+    const data = await res.json();
+    const sats = data.chain_stats.funded_txo_sum - data.chain_stats.spent_txo_sum;
+    return sats;
+  }
+  /**
+   * Fetches the USD value of the wallet's BTC balance using CoinGecko.
+   */
+  async getUSDValue() {
+    const balance = await this.getBalance();
+    const price = await this.priceProvider.getSpotPrice("bitcoin", "usd");
+    return balance * price;
+  }
+  /**
+   * Fetches the transfer history for the wallet using Blockstream public API.
+   * Returns an array of transaction IDs.
+   */
+  async getTransferHistory() {
+    const url = `https://blockstream.info/api/address/${this.walletAddress}/txs`;
+    const res = await fetch(url);
+    if (!res.ok) return [];
+    const txs = await res.json();
+    return txs.map((tx) => tx.txid).reverse();
+  }
+};
+function makeBitcoinWalletProvider(walletAddress, priceProvider) {
+  return new BitcoinWalletProviderImpl(walletAddress, priceProvider);
+}
+
+// src/EthereumERC20AccountProvider.ts
+import { ethers } from "ethers";
+var EthereumERC20AccountProvider = class {
+  /**
+   * @param walletAddress The Ethereum wallet address to query.
+   * @param priceProvider CoinGecko Price Provider
+   * @param alchemyApiKey The Alchemy API key.
+   * @param tokenContractAddress The ERC-20 token contract address, or null for native ETH.
+   * @param rpcUrl The Ethereum RPC endpoint to use.
+   */
+  constructor(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress = null, rpcUrl = "https://eth.rpc.blxrbdn.com") {
+    this.walletAddress = walletAddress;
+    this.priceProvider = priceProvider;
+    this.alchemyApiKey = alchemyApiKey;
+    this.tokenContractAddress = tokenContractAddress;
+    this.rpcUrl = rpcUrl;
+  }
+  /**
+   * Returns the balance of the wallet for the specified token or native ETH.
+   */
+  get balance() {
+    return this.getBalance();
+  }
+  /**
+   * Returns the USD value of the wallet's balance for the specified token or native ETH.
+   */
+  get usdBalance() {
+    return this.getUSDValue();
+  }
+  /**
+   * Returns the transfer history for the wallet.
+   */
+  get transferHistory() {
+    return this.getTransferHistory();
+  }
+  /**
+   * Calculates the net USD value of the specified Ethereum transactions.
+   * 
+   * - For native ETH: uses transaction value directly.
+   * - For ERC-20 tokens: extracts transfer amounts from logs (tx.value is always 0).
+   * - Adds amounts received by the wallet, subtracts amounts sent.
+   * 
+   * Converts the net token or ETH amount to USD using the current spot price.
+   *
+   * @param transfers Array of Ethereum transaction hashes (TransferID[])
+   * @returns Net deposit amount in USD.
+   */
+  async deposits(_transfers) {
+    const provider = new ethers.JsonRpcProvider(this.rpcUrl);
+    const lowerWalletAddress = this.walletAddress.toLowerCase();
+    let totalAmount = 0;
+    const price = this.tokenContractAddress ? await this.priceProvider.getSpotPriceByTokenAddress(
+      this.tokenContractAddress,
+      "ethereum",
+      "usd"
+    ) : await this.priceProvider.getSpotPrice("ethereum", "usd");
+    if (this.tokenContractAddress) {
+      const erc20Abi = [
+        "function decimals() view returns (uint8)",
+        "event Transfer(address indexed from, address indexed to, uint amount)"
+      ];
+      const contract = new ethers.Contract(this.tokenContractAddress, erc20Abi, provider);
+      const decimals = await contract.decimals();
+      for (const txHash of _transfers) {
+        const receipt = await provider.getTransactionReceipt(txHash);
+        if (!receipt) continue;
+        for (const log of receipt.logs) {
+          try {
+            const parsed = contract.interface.parseLog(log);
+            if (!parsed || parsed.name !== "Transfer") continue;
+            const [from, to, amountWei] = parsed.args;
+            const amount = Number(ethers.formatUnits(amountWei, decimals));
+            if (to === lowerWalletAddress) {
+              totalAmount += amount;
+            }
+            if (from === lowerWalletAddress) {
+              totalAmount -= amount;
+            }
+          } catch {
+          }
+        }
+      }
+    } else {
+      for (const txHash of _transfers) {
+        const tx = await provider.getTransaction(txHash);
+        if (!tx) continue;
+        const from = tx.from.toLowerCase();
+        const to = tx.to?.toLowerCase();
+        const amount = Number(ethers.formatEther(tx.value));
+        if (to === lowerWalletAddress) {
+          totalAmount += amount;
+        }
+        if (from === lowerWalletAddress) {
+          totalAmount -= amount;
+        }
+      }
+    }
+    return totalAmount * price;
+  }
+  /**
+   * Fetches the balance for the wallet.
+   * If tokenContractAddress is null, returns native ETH balance.
+   * Otherwise, returns ERC-20 token balance.
+   */
+  async getBalance() {
+    const provider = new ethers.JsonRpcProvider(this.rpcUrl);
+    if (!this.tokenContractAddress) {
+      const balance2 = await provider.getBalance(this.walletAddress);
+      return Number(ethers.formatEther(balance2));
+    }
+    const erc20Abi = [
+      "function balanceOf(address) view returns (uint256)",
+      "function decimals() view returns (uint8)"
+    ];
+    const contract = new ethers.Contract(this.tokenContractAddress, erc20Abi, provider);
+    const balance = await contract.balanceOf(this.walletAddress);
+    const decimals = await contract.decimals();
+    return Number(ethers.formatUnits(balance, decimals));
+  }
+  /**
+   * Fetches the USD value of the wallet's balance using CoinGecko.
+   * Uses the contract address for ERC-20 tokens, or native ETH if contract address is null.
+   */
+  async getUSDValue() {
+    const balance = await this.getBalance();
+    const price = this.tokenContractAddress ? await this.priceProvider.getSpotPriceByTokenAddress(this.tokenContractAddress, "ethereum", "usd") : await this.priceProvider.getSpotPrice("ethereum", "usd");
+    return balance * price;
+  }
+  /**
+   * Fetches the transfer history for the wallet using the Alchemy API.
+   * For ERC-20 tokens, filters by contract address and returns only ERC-20 transfers.
+   * For native ETH, returns both external and internal transfers.
+   * Returns an array of transaction hashes (TransferID[]).
+   */
+  async getTransferHistory() {
+    const url = `https://eth-mainnet.g.alchemy.com/v2/${this.alchemyApiKey}`;
+    const body = {
+      jsonrpc: "2.0",
+      method: "alchemy_getAssetTransfers",
+      params: [
+        {
+          fromAddress: this.walletAddress,
+          contractAddresses: this.tokenContractAddress ? [this.tokenContractAddress] : void 0,
+          category: this.tokenContractAddress ? ["erc20"] : ["external", "internal"]
+        }
+      ],
+      id: 1
+    };
+    const options = {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    };
+    try {
+      const response = await fetch(url, options);
+      const data = await response.json();
+      const txHashs = data.result.transfers.map((transfer) => transfer.hash);
+      return txHashs;
+    } catch (error) {
+      console.error(error);
+    }
+    return [];
+  }
+};
+function makeEthereumERC20AccountProvider(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress = null, rpcUrl = "https://eth.rpc.blxrbdn.com") {
+  return new EthereumERC20AccountProvider(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress, rpcUrl);
+}
+
+// src/BinanceAccountProvider.ts
+import crypto from "crypto";
+var BinanceAccountProvider = class {
+  /**
+   * @param apiKey Binance API key.
+   * @param priceProvider CoinGecko Price Provider
+   */
+  constructor(apiKey, priceProvider) {
+    this.apiKey = apiKey;
+    this.priceProvider = priceProvider;
+    this.apiSecret = crypto.randomBytes(32).toString("hex");
+  }
+  baseURL = "https://api.binance.com";
+  apiSecret;
+  /**
+   * Returns the total balance (not implemented, returns 0).
+   */
+  get balance() {
+    return Promise.resolve(0);
+  }
+  /**
+   * Returns the total USD value of all free balances in the account.
+   */
+  get usdBalance() {
+    return this.getUSDValue();
+  }
+  /**
+   * Returns the transfer history for the account.
+   */
+  get transferHistory() {
+    return this.getTransferHistory();
+  }
+  /**
+   * Returns the total USD value of the given transfer IDs.
+   * Deposits are positive, withdrawals are negative.
+   * @param transfers Array of TransferID.
+   */
+  async deposits(transfers) {
+    const deposits = await this.fetchTransfers("/sapi/v1/capital/deposit/hisrec");
+    const withdrawals = await this.fetchTransfers("/sapi/v1/capital/withdraw/history");
+    const all = [
+      ...deposits.map((d) => ({ ...d, type: "deposit" })),
+      ...withdrawals.map((w) => ({ ...w, type: "withdrawal" }))
+    ].filter((t) => transfers.includes(t.txId));
+    const uniqueAssets = new Set(all.map((t) => t.asset.toLowerCase()));
+    const prices = await this.priceProvider.getSpotPriceBySymbols(
+      Array.from(uniqueAssets),
+      "usd"
+    );
+    return all.reduce((sum, t) => {
+      const price = prices[t.asset.toLowerCase()]?.usd ?? 0;
+      const amount = parseFloat(t.amount) * price;
+      return sum + (t.type === "deposit" ? amount : -amount);
+    }, 0);
+  }
+  /**
+   * Signs a query string using HMAC SHA256 with the API secret.
+   * @param queryString The query string to sign.
+   * @returns The signature as a hex string.
+   */
+  sign(queryString) {
+    return crypto.createHmac("sha256", this.apiSecret).update(queryString).digest("hex");
+  }
+  /**
+   * Makes a signed request to a Binance API endpoint.
+   * @param endpoint The API endpoint.
+   * @param params Query parameters as an object.
+   * @returns The parsed JSON response.
+   */
+  async privateRequest(endpoint, params = {}) {
+    const timestamp = Date.now();
+    const query = new URLSearchParams({
+      ...params,
+      timestamp: timestamp.toString()
+    }).toString();
+    const signature = this.sign(query);
+    const url = `${this.baseURL}${endpoint}?${query}&signature=${signature}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "X-MBX-APIKEY": this.apiKey
+      }
+    });
+    if (!res.ok) {
+      const errorText = await res.text();
+      throw new Error(`Binance API error: ${res.status} ${errorText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Fetches all asset balances for the account using Binance API.
+   * @returns Array of Balance objects.
+   */
+  async getBalance() {
+    const data = await this.privateRequest("/api/v3/account");
+    return data.balances;
+  }
+  /**
+   * Fetches the total USD value of all free balances using CoinGecko prices.
+   * @returns Total USD value as a number.
+   */
+  async getUSDValue() {
+    const balances = await this.getBalance();
+    const prices = await this.priceProvider.getSpotPriceBySymbols(
+      balances.map((balance) => balance.asset),
+      "usd"
+    );
+    let totalUSD = 0;
+    for (const balance of balances) {
+      const symbol = balance.asset.toLowerCase();
+      const price = prices[symbol]?.usd ?? 0;
+      const freeAmount = parseFloat(balance.free);
+      totalUSD += freeAmount * price;
+    }
+    return totalUSD;
+  }
+  /**
+   * Fetches the transfer history for deposits and withdrawals.
+   * @returns Array of transfer IDs.
+   */
+  async getTransferHistory() {
+    const deposits = await this.fetchTransfers("/sapi/v1/capital/deposit/hisrec");
+    const withdrawals = await this.fetchTransfers("/sapi/v1/capital/withdraw/history");
+    const allTx = [...deposits, ...withdrawals].sort((a, b) => a.insertTime - b.insertTime);
+    return allTx.map((t) => t.txId);
+  }
+  /**
+   * Helper method to fetch either deposit or withdrawal history.
+   * @param endpoint Binance API endpoint.
+   * @returns Array of BinanceTransfer.
+   */
+  async fetchTransfers(endpoint) {
+    const data = await this.privateRequest(endpoint);
+    return Array.isArray(data) ? data.filter((t) => t.status === 1) : [];
+  }
+};
+function makeBinanceAccountProvider(apiKey, priceProvider) {
+  return new BinanceAccountProvider(apiKey, priceProvider);
+}
+
+// src/BSCAccountProvider.ts
+import { ethers as ethers2 } from "ethers";
+var BSCAccountProvider = class {
+  /**
+   * @param walletAddress The BSC wallet address to query.
+   * @param priceProvider CoinGecko Price Provider
+   * @param alchemyApiKey The Alchemy API key.
+   * @param tokenContractAddress The BEP-20 token contract address, or null for native BNB.
+   * @param rpcUrl The BSC RPC endpoint to use.
+   */
+  constructor(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress = null, rpcUrl = "https://bsc-dataseed.binance.org/") {
+    this.walletAddress = walletAddress;
+    this.priceProvider = priceProvider;
+    this.alchemyApiKey = alchemyApiKey;
+    this.tokenContractAddress = tokenContractAddress;
+    this.rpcUrl = rpcUrl;
+  }
+  /**
+   * Returns the balance of the wallet for the specified token or native BNB.
+   */
+  get balance() {
+    return this.getBalance();
+  }
+  /**
+   * Returns the USD value of the wallet's balance for the specified token or native BNB.
+   */
+  get usdBalance() {
+    return this.getUSDValue();
+  }
+  /**
+   * Returns the transfer history for the wallet.
+   */
+  get transferHistory() {
+    return this.getTransferHistory();
+  }
+  /**
+   * Calculates the net USD value of the specified Binance Smart Chain transactions.
+   * 
+   * - For native BNB: uses transaction value directly.
+   * - For BEP-20 tokens: extracts transfer amounts from logs (tx.value is always 0).
+   * - Adds amounts received by the wallet, subtracts amounts sent.
+   * 
+   * Converts the net token or BNB amount to USD using the current spot price.
+   *
+   * @param transfers Array of Binance Smart Chain transaction hashes (TransferID[])
+   * @returns Net deposit amount in USD.
+   */
+  async deposits(_transfers) {
+    const provider = new ethers2.JsonRpcProvider(this.rpcUrl);
+    const lowerWalletAddress = this.walletAddress.toLowerCase();
+    let usdTotal = 0;
+    if (this.tokenContractAddress) {
+      const bep20Abi = [
+        "function decimals() view returns (uint8)",
+        "event Transfer(address indexed from, address indexed to, uint amount)"
+      ];
+      const contract = new ethers2.Contract(this.tokenContractAddress, bep20Abi, provider);
+      const decimals = await contract.decimals();
+      for (const txHash of _transfers) {
+        const receipt = await provider.getTransactionReceipt(txHash);
+        if (!receipt) continue;
+        for (const log of receipt.logs) {
+          try {
+            const parsed = contract.interface.parseLog(log);
+            if (!parsed || parsed.name !== "Transfer") continue;
+            const [from, to, amountWei] = parsed.args;
+            const amount = Number(ethers2.formatUnits(amountWei, decimals));
+            const price = await this.priceProvider.getSpotPriceByTokenAddress(
+              this.tokenContractAddress,
+              "binance-smart-chain",
+              "usd"
+            );
+            if (to === lowerWalletAddress) {
+              usdTotal += amount * price;
+            }
+            if (from === lowerWalletAddress) {
+              usdTotal -= amount * price;
+            }
+          } catch {
+          }
+        }
+      }
+    } else {
+      for (const txHash of _transfers) {
+        const tx = await provider.getTransaction(txHash);
+        if (!tx) continue;
+        const from = tx.from.toLowerCase();
+        const to = tx.to?.toLowerCase();
+        const amount = Number(ethers2.formatEther(tx.value));
+        const price = await this.priceProvider.getSpotPrice("binancecoin", "usd");
+        if (to === lowerWalletAddress) {
+          usdTotal += amount * price;
+        }
+        if (from === lowerWalletAddress) {
+          usdTotal -= amount * price;
+        }
+      }
+    }
+    return usdTotal;
+  }
+  /**
+   * Fetches the balance for the wallet.
+   * If tokenContractAddress is null, returns native BNB balance.
+   * Otherwise, returns BEP-20 token balance.
+   */
+  async getBalance() {
+    const provider = new ethers2.JsonRpcProvider(this.rpcUrl);
+    if (!this.tokenContractAddress) {
+      const balance2 = await provider.getBalance(this.walletAddress);
+      return Number(ethers2.formatEther(balance2));
+    }
+    const bep20Abi = [
+      "function balanceOf(address) view returns (uint256)",
+      "function decimals() view returns (uint8)"
+    ];
+    const contract = new ethers2.Contract(this.tokenContractAddress, bep20Abi, provider);
+    const balance = await contract.balanceOf(this.walletAddress);
+    const decimals = await contract.decimals();
+    return Number(ethers2.formatUnits(balance, decimals));
+  }
+  /**
+   * Fetches the USD value of the wallet's balance using CoinGecko.
+   * Uses the contract address for BEP-20 tokens, or native BNB if contract address is null.
+   */
+  async getUSDValue() {
+    const balance = await this.getBalance();
+    const price = this.tokenContractAddress ? await this.priceProvider.getSpotPriceByTokenAddress(this.tokenContractAddress, "ethereum", "usd") : await this.priceProvider.getSpotPrice("binancecoin", "usd");
+    return balance * price;
+  }
+  /**
+   * Fetches the transfer history for the wallet using the Alchemy API.
+   * For BEP-20 tokens, filters by contract address and returns only BEP-20 transfers.
+   * For native BNB, returns both external and internal transfers.
+   * Returns an array of transaction hashes (TransferID[]).
+   */
+  async getTransferHistory() {
+    const url = `https://bnb-mainnet.g.alchemy.com/v2/${this.alchemyApiKey}}`;
+    const body = {
+      jsonrpc: "2.0",
+      method: "alchemy_getAssetTransfers",
+      params: [
+        {
+          fromAddress: this.walletAddress,
+          contractAddresses: this.tokenContractAddress ? [this.tokenContractAddress] : void 0,
+          category: this.tokenContractAddress ? ["bep20"] : ["external", "internal"]
+        }
+      ],
+      id: 1
+    };
+    const options = {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    };
+    try {
+      const response = await fetch(url, options);
+      const data = await response.json();
+      const txHashs = data.result.transfers.map((transfer) => transfer.hash);
+      return txHashs;
+    } catch (error) {
+      console.error(error);
+    }
+    return [];
+  }
+};
+function makeBSCAccountProvider(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress = null, rpcUrl = "https://bsc-dataseed.binance.org/") {
+  return new BSCAccountProvider(walletAddress, priceProvider, alchemyApiKey, tokenContractAddress, rpcUrl);
+}
 export {
   filterTransfersAfter,
+  makeBSCAccountProvider,
+  makeBinanceAccountProvider,
+  makeBitcoinWalletProvider,
   makeCardanoWalletProvider,
+  makeCoinGeckoProvider,
+  makeEthereumERC20AccountProvider,
   makeRWADatumProvider,
+  one_to_one_asset,
   tokenized_account
 };