@ercworldio/blockchain-shared 1.0.1-dev.9 → 1.0.2-dev-PROJ-1265.1

package/README.md

@@ -1 +1,27 @@
 ## README
+
+# blockchain-shared
+
+Shared TypeScript library for multi-chain blockchain infrastructure used across projectx services.
+
+## What it does
+
+- Manages deposit addresses, wallet indexes, and custodial/hot wallets
+- Handles balances, withdrawals, sweeps, and claims across chains
+- Abstracts RPC providers and chain configuration
+- Processes on-chain events via Alchemy and Quicknode webhooks
+- Integrates with Azure KeyVault, Redis, and PostgreSQL
+
+## Supported chains
+
+EVM (Ethereum, BSC, Avalanche, Polygon, Fantom, Bitlayer, Monad), Solana, Tron, Bitcoin, Lightning
+
+## Stack
+
+TypeScript · ethers.js v6 · @solana/web3.js · TronWeb · TypeORM · Redis · Azure
+
+## Install
+
+```bash
+npm install @ercworldio/blockchain-shared
+```

package/build/chains/networks_dev.json

@@ -38,13 +38,18 @@
         },
         "tronConfig": {
             "trxTransferCost": 270000,
-            "trc20TransferCost": 4000000
+            "trc20TransferCost": 4000000,
+            "rentEnergyWallet": "TCdE3ZGvBjUcqVCreT25SWwF36gkiLYTGD"
         },
         "accounting": {
             "funding_wallet": "TN4tXH5F36BxWEe8UQuUeMr1EuPwJjNUFJ",
             "treasury_receiver": "TN4tXH5F36BxWEe8UQuUeMr1EuPwJjNUFJ",
             "overflow_treasury_receiver": "TCdE3ZGvBjUcqVCreT25SWwF36gkiLYTGD",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "TCdE3ZGvBjUcqVCreT25SWwF36gkiLYTGD"
+            ]
         },
         "rpcBaseUrl": "https://api.nileex.io",
         "rpcBaseUrlWss": "",
@@ -79,7 +84,10 @@
                 "decimals": 6,
                 "address": "0000000000000000000000000000000000000000",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 6
+                "sweepWalletMinBalance": 6,
+                "recommendedMinBalanceFundingWallet": 300,
+                "recommendedMinBalanceEscrow": 0,
+                "recommendedMinBalanceRentEnergy": 50
             },
             {
                 "name": "Tether Token",
@@ -90,7 +98,10 @@
                 "decimals": 6,
                 "address": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
                 "sweepThreshold": 1,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 100,
+                "recommendedMinBalanceEscrow": 0,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -103,12 +114,16 @@
         "blockexplorerUrl": "https://solscan.io/?cluster=devnet",
         "rpcBaseUrl": "https://rpc.ankr.com/solana_devnet",
         "rpcBaseUrlWss": "wss://rpc.ankr.com/solana_devnet/ws",
-        "targetConfirmations": 2,
+        "targetConfirmations": 32,
         "accounting": {
             "funding_wallet": "GLfRJqsRtTNDVvYVccXrz8RCKNnad2hqQfgFaApAKXCq",
             "treasury_receiver": "AAuFzrm6H4Vv7UyJi8R5Gsm4ixtR2yVmqzLmuyUTS5cu",
             "overflow_treasury_receiver": "GLfRJqsRtTNDVvYVccXrz8RCKNnad2hqQfgFaApAKXCq",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "AAuFzrm6H4Vv7UyJi8R5Gsm4ixtR2yVmqzLmuyUTS5cu"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -121,6 +136,13 @@
             }
         ],
         "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-sol-dev",
+                "network": "solana-devnet",
+                "template": "solanaWalletFilter",
+                "source": "contract",
+                "chain_id": 103
+            },
             {
                 "name": "qn-custodial-webhook-sol-dev",
                 "network": "solana-devnet",
@@ -165,7 +187,10 @@
                 "decimals": 9,
                 "address": "11111111111111111111111111111111",
                 "sweepThreshold": 0.05,
-                "sweepWalletMinBalance": 0.01
+                "sweepWalletMinBalance": 0.01,
+                "recommendedMinBalanceFundingWallet": 0.25,
+                "recommendedMinBalanceEscrow": 10,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Circle Token",
@@ -176,7 +201,10 @@
                 "decimals": 6,
                 "address": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
                 "sweepThreshold": 1,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -194,7 +222,11 @@
             "funding_wallet": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
             "treasury_receiver": "0xaD372aCDd0F14A9430Af29DaEc8229A9F109d7F5",
             "overflow_treasury_receiver": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0xaD372aCDd0F14A9430Af29DaEc8229A9F109d7F5"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -252,7 +284,10 @@
                 "decimals": 18,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 0.015,
-                "sweepWalletMinBalance": 0.0015
+                "sweepWalletMinBalance": 0.0015,
+                "recommendedMinBalanceFundingWallet": 0.1,
+                "recommendedMinBalanceEscrow": 1,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -263,7 +298,10 @@
                 "isStableCoin": true,
                 "address": "0x24607248E7F55B28548971B75A64d74515b49584",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -325,7 +363,10 @@
                 "decimals": 18,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 0.1,
-                "sweepWalletMinBalance": 0.01
+                "sweepWalletMinBalance": 0.01,
+                "recommendedMinBalanceFundingWallet": 10,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -335,7 +376,10 @@
                 "decimals": 6,
                 "address": "0x00E15B31f48aC6DB632aABf5B656e118b31b1BeB",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -353,7 +397,11 @@
             "funding_wallet": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
             "treasury_receiver": "0x89DecB6b265D7714A69EE05E3Bc50Fd829D7Ef90",
             "overflow_treasury_receiver": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0x89DecB6b265D7714A69EE05E3Bc50Fd829D7Ef90"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -411,7 +459,10 @@
                 "decimals": 18,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 0.1,
-                "sweepWalletMinBalance": 0.01
+                "sweepWalletMinBalance": 0.01,
+                "recommendedMinBalanceFundingWallet": 3,
+                "recommendedMinBalanceEscrow": 50,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -422,7 +473,10 @@
                 "decimals": 6,
                 "address": "0x6F8cCEFD7Ba389713C3DCFA6C145f2d4fC2731a9",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -454,7 +508,11 @@
             "funding_wallet": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
             "treasury_receiver": "0xEA8Ad078561B83724EEcDBb5b5A4f03369115Cf8",
             "overflow_treasury_receiver": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0xEA8Ad078561B83724EEcDBb5b5A4f03369115Cf8"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -512,7 +570,10 @@
                 "decimals": 18,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 0.00033,
-                "sweepWalletMinBalance": 0.001
+                "sweepWalletMinBalance": 0.001,
+                "recommendedMinBalanceFundingWallet": 0.05,
+                "recommendedMinBalanceEscrow": 0.5,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -523,7 +584,10 @@
                 "decimals": 6,
                 "address": "0xd36A20dB12953F0bf09C66B08c1771ae046D2152",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -541,7 +605,11 @@
             "funding_wallet": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
             "treasury_receiver": "0x69E1F9316E03Da502B52f4682b0349d36CFBfFfD",
             "overflow_treasury_receiver": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 1,
+            "allowed_receivers": [
+                "0x69E1F9316E03Da502B52f4682b0349d36CFBfFfD"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -598,7 +666,10 @@
                 "isStableCoin": false,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.01
+                "sweepWalletMinBalance": 0.01,
+                "recommendedMinBalanceFundingWallet": 100,
+                "recommendedMinBalanceEscrow": 1000,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -609,7 +680,10 @@
                 "isStableCoin": true,
                 "address": "0x6F8cCEFD7Ba389713C3DCFA6C145f2d4fC2731a9",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     },
@@ -627,7 +701,11 @@
             "funding_wallet": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
             "treasury_receiver": "0xf4BE5695F5eCd281171ab625ceb59bEee081e14f",
             "overflow_treasury_receiver": "0xF84a78E56fBACAADd73E59eDAe02b3b80e4966C8",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 0.5,
+            "allowed_receivers": [
+                "0xf4BE5695F5eCd281171ab625ceb59bEee081e14f"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -640,6 +718,13 @@
             }
         ],
         "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-mon-dev",
+                "network": "monad-testnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 10143
+            },
             {
                 "name": "qn-custodial-webhook-mon-dev",
                 "network": "monad-testnet",
@@ -684,7 +769,10 @@
                 "decimals": 18,
                 "address": "0x0000000000000000000000000000000000000000",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 50,
+                "recommendedMinBalanceEscrow": 500,
+                "recommendedMinBalanceRentEnergy": 0
             },
             {
                 "name": "Tether Token",
@@ -695,7 +783,10 @@
                 "decimals": 6,
                 "address": "0xc60f378d2C9Cc06c4830B788976bc1003d5159fe",
                 "sweepThreshold": 10,
-                "sweepWalletMinBalance": 0.1
+                "sweepWalletMinBalance": 0.1,
+                "recommendedMinBalanceFundingWallet": 0,
+                "recommendedMinBalanceEscrow": 100,
+                "recommendedMinBalanceRentEnergy": 0
             }
         ]
     }

package/build/chains/networks_prod-bu.json

@@ -13,7 +13,11 @@
             "funding_wallet": "0xd81C736189d255379a9510a4E11A27d559Cc5695",
             "treasury_receiver": "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C",
             "overflow_treasury_receiver": "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -25,6 +29,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-eth-prod-bu",
+                "network": "ethereum-mainnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 1
+            },
+            {
+                "name": "qn-custodial-webhook-eth-prod-bu",
+                "network": "ethereum-mainnet",
+                "template": "evmWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -93,7 +111,11 @@
             "funding_wallet": "0xd81C736189d255379a9510a4E11A27d559Cc5695",
             "treasury_receiver": "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C",
             "overflow_treasury_receiver": "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0x7F625Ba70fA13694218cD68b14F99EEF3518eC7C"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -105,6 +127,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-bnb-prod-bu",
+                "network": "bnbchain-mainnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 56
+            },
+            {
+                "name": "qn-custodial-webhook-bnb-prod-bu",
+                "network": "bnbchain-mainnet",
+                "template": "evmWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -168,12 +204,14 @@
         "blockexplorerUrl": "https://solscan.io",
         "rpcBaseUrl": "https://rpc.ankr.com/solana",
         "rpcBaseUrlWss": "wss://rpc.ankr.com/solana/ws",
-        "targetConfirmations": 2,
+        "targetConfirmations": 32,
         "accounting": {
             "funding_wallet": "EvEmp35XMdWcsG3sULndr2Vb5yiLcA9JCfSBw5A6bXk6",
             "treasury_receiver": "67e3Robajph3KSAq3VDuYL21xifkCmD5y28DPwMecu7S",
             "overflow_treasury_receiver": "67e3Robajph3KSAq3VDuYL21xifkCmD5y28DPwMecu7S",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": []
         },
         "custodialAlchemyWebhooks": [
             {
@@ -185,6 +223,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-sol-prod-bu",
+                "network": "solana-mainnet",
+                "template": "solanaWalletFilter",
+                "source": "contract",
+                "chain_id": 101
+            },
+            {
+                "name": "qn-custodial-webhook-sol-prod-bu",
+                "network": "solana-mainnet",
+                "template": "solanaWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -253,7 +305,11 @@
             "funding_wallet": "0xd81C736189d255379a9510a4E11A27d559Cc5695",
             "treasury_receiver": "0xE75526AaD30364d198b8553C716Aa9DDc2f8BD26",
             "overflow_treasury_receiver": "0xE75526AaD30364d198b8553C716Aa9DDc2f8BD26",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0xE75526AaD30364d198b8553C716Aa9DDc2f8BD26"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -265,6 +321,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-pol-prod-bu",
+                "network": "polygon-mainnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 137
+            },
+            {
+                "name": "qn-custodial-webhook-pol-prod-bu",
+                "network": "polygon-mainnet",
+                "template": "evmWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -333,7 +403,11 @@
             "funding_wallet": "0xd81C736189d255379a9510a4E11A27d559Cc5695",
             "treasury_receiver": "0xD7205fD63Fa5def834DD3556c149FF7911478391",
             "overflow_treasury_receiver": "0xD7205fD63Fa5def834DD3556c149FF7911478391",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0xD7205fD63Fa5def834DD3556c149FF7911478391"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -345,6 +419,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-mon-prod-bu",
+                "network": "monad-mainnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 143
+            },
+            {
+                "name": "qn-custodial-webhook-mon-prod-bu",
+                "network": "monad-mainnet",
+                "template": "evmWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -402,7 +490,11 @@
             "funding_wallet": "0xd81C736189d255379a9510a4E11A27d559Cc5695",
             "treasury_receiver": "0xedb9e987Da3806205D2f1e246Eb8c538A872783E",
             "overflow_treasury_receiver": "0xedb9e987Da3806205D2f1e246Eb8c538A872783E",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": [
+                "0xedb9e987Da3806205D2f1e246Eb8c538A872783E"
+            ]
         },
         "custodialAlchemyWebhooks": [
             {
@@ -414,6 +506,20 @@
                 "source": "wallet"
             }
         ],
+        "quicknodeNotificationConfig": [
+            {
+                "name": "escrow-avax-prod-bu",
+                "network": "avalanche-mainnet",
+                "template": "evmWalletFilter",
+                "source": "contract",
+                "chain_id": 43114
+            },
+            {
+                "name": "qn-custodial-webhook-avax-prod-bu",
+                "network": "avalanche-mainnet",
+                "template": "evmWalletFilter"
+            }
+        ],
         "contracts": [
             {
                 "type": "Escrow",
@@ -483,7 +589,9 @@
             "funding_wallet": "TTxo5LeNkq5g9sywaGdXjttKRvoum8xSGp",
             "treasury_receiver": "TTxo5LeNkq5g9sywaGdXjttKRvoum8xSGp",
             "overflow_treasury_receiver": "TTxo5LeNkq5g9sywaGdXjttKRvoum8xSGp",
-            "overflow_threshold_decimal": 100000
+            "overflow_threshold_decimal": 100000,
+            "min_funding_wallet_balance_usd": 5,
+            "allowed_receivers": []
         },
         "rpcMetadata": {
             "rpcBaseUrl": "https://rpc.ankr.com/premium-http/tron",