{"_id":"@d13co/algo-group-balance-impact","name":"@d13co/algo-group-balance-impact","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@d13co/algo-group-balance-impact","version":"0.0.1","type":"module","description":"Calculate Txn and Group Balance Impact for Algorand","main":"dist/index.cjs","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"scripts":{"build":"tsup","lint":"eslint src --ext .ts","lint:fix":"eslint src --ext .ts --fix","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","typecheck":"tsc --noEmit","prepare":"husky","test":"echo \"No tests configured\" && exit 0"},"keywords":["typescript","algorand"],"author":{"name":"D13"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/d13co/algo-group-balance-changes.git"},"homepage":"https://github.com/d13co/algo-group-balance-changes#readme","bugs":{"url":"https://github.com/d13co/algo-group-balance-changes/issues"},"devDependencies":{"@eslint/js":"^9.0.0","@types/node":"^20.11.0","eslint":"^9.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-prettier":"^5.1.0","husky":"^9.0.0","lint-staged":"^15.2.0","prettier":"^3.2.0","tsup":"^8.0.0","typescript":"^5.3.0","typescript-eslint":"^8.0.0"},"lint-staged":{"*.ts":["eslint --fix","prettier --write"]},"peerDependencies":{"@algorandfoundation/algokit-utils":"^9.2.0","algosdk":"^3.5.2"},"_id":"@d13co/algo-group-balance-impact@0.0.1","gitHead":"e9cc36c94c91ca1c00728055754fd8f78b74ee62","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-oXQERt+k4hyEt1MSV7t1xWnsQDQoq/iiKkoB2SUUJmSPCsMrK2U5cBtRsVLY312aNWQAqyIZJURIGNBhCN+TcA==","shasum":"5263a74d49893fd62a69dbc02e52d10a29fd9085","tarball":"https://registry.npmjs.org/@d13co/algo-group-balance-impact/-/algo-group-balance-impact-0.0.1.tgz","fileCount":8,"unpackedSize":60030,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDUjKlCBi3wLnBpl+6MPbnfiSpCB8u3VtueujRzXgK59AIhAIwPV3zdrUWCVARhxgAcQwyFdLEY4FPiVhnkS7PKStSK"}]},"_npmUser":{"name":"bitd13co","email":"bit@d13.co"},"directories":{},"maintainers":[{"name":"bitd13co","email":"bit@d13.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/algo-group-balance-impact_0.0.1_1770171148383_0.3206592463897435"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-04T02:12:28.273Z","0.0.1":"2026-02-04T02:12:28.575Z","modified":"2026-02-04T02:12:28.838Z"},"maintainers":[{"name":"bitd13co","email":"bit@d13.co"}],"description":"Calculate Txn and Group Balance Impact for Algorand","homepage":"https://github.com/d13co/algo-group-balance-changes#readme","keywords":["typescript","algorand"],"repository":{"type":"git","url":"git+https://github.com/d13co/algo-group-balance-changes.git"},"author":{"name":"D13"},"bugs":{"url":"https://github.com/d13co/algo-group-balance-changes/issues"},"license":"MIT","readme":"# @d13co/algo-group-balance-impact\n\nCalculate the net balance impact of Algorand transaction groups.\n\n## Installation\n\n```bash\nnpm install @d13co/algo-group-balance-impact\n```\n\n## Usage\n\n```typescript\nimport { AlgorandClient } from '@algorandfoundation/algokit-utils';\nimport { calculateGroupBalanceImpact } from '@d13co/algo-group-balance-impact';\n\nconst { client: { indexer } } = await AlgorandClient.mainNet();\n\nconst result = await calculateGroupBalanceImpact({\n  indexer,\n  groupId: 'your-group-id',\n  round: 12345678,\n  convertDecimals: true,  // Convert amounts using asset decimals\n  unitNameKeys: true,     // Use unit names (e.g., \"ALGO\") instead of asset IDs\n});\n\nif (result) {\n  console.log(result.balanceImpact);\n  // {\n  //   \"ADDR1...\": { \"ALGO\": -1.5, \"USDC\": 100 },\n  //   \"ADDR2...\": { \"ALGO\": 1.5, \"USDC\": -100 }\n  // }\n}\n```\n\n## API\n\n### `calculateGroupBalanceImpact(params)`\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `indexer` | `Indexer` | Algorand indexer client |\n| `txnId` | `string?` | Transaction ID to lookup group |\n| `txn` | `Transaction?` | Transaction object to lookup group |\n| `groupId` | `string?` | Group ID (requires `round`) |\n| `round` | `number?` | Block round (required with `groupId`) |\n| `block` | `Block?` | Cached block to avoid re-fetching |\n| `convertDecimals` | `boolean?` | Convert to decimal amounts |\n| `unitNameKeys` | `boolean?` | Use asset unit names as keys |\n| `includeFees` | `boolean?` | Include transaction fees in balance |\n\nReturns `GroupBalanceImpactResult` with `balanceImpact`, `group`, and `block`.\n\n## License\n\nMIT\n\n","readmeFilename":"README.md","_rev":"1-1f65e435f5670a2c20b3732e369e47fd"}