@oracle-agent/oracle 0.14.1 → 0.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/SETUP.md +4 -4
- package/dist/action-receipts.mjs +1 -0
- package/dist/action-semantics.mjs +1 -0
- package/dist/address-book.mjs +2 -0
- package/dist/bin/desk-server.mjs +59 -0
- package/dist/bin/oracle-data-mcp.mjs +8 -0
- package/dist/bin/oracle-equities.mjs +20 -0
- package/dist/bin/oracle-init.mjs +24 -0
- package/dist/bin/oracle-public-server.mjs +5 -0
- package/dist/bin/oracle-route.mjs +22 -0
- package/dist/bin/oracle-scan.mjs +18 -0
- package/dist/bin/oracle-upgrade.mjs +21 -0
- package/dist/bin/oracle.mjs +61 -0
- package/dist/chains.mjs +1 -0
- package/dist/cli/commands/auth.mjs +16 -0
- package/dist/cli/commands/bootstrap.mjs +18 -0
- package/dist/cli/commands/chain.mjs +21 -0
- package/dist/cli/commands/chat.mjs +45 -0
- package/dist/cli/commands/credential.mjs +1 -0
- package/dist/cli/commands/data-mcp.mjs +2 -0
- package/dist/cli/commands/data.mjs +12 -0
- package/dist/cli/commands/doctor.mjs +5 -0
- package/dist/cli/commands/equities.mjs +15 -0
- package/dist/cli/commands/farm.mjs +59 -0
- package/dist/cli/commands/fees.mjs +10 -0
- package/dist/cli/commands/follow.mjs +28 -0
- package/dist/cli/commands/harness.mjs +15 -0
- package/dist/cli/commands/help.mjs +1 -0
- package/dist/cli/commands/init.mjs +3 -0
- package/dist/cli/commands/mcp.mjs +36 -0
- package/dist/cli/commands/model.mjs +54 -0
- package/dist/cli/commands/plugins.mjs +43 -0
- package/dist/cli/commands/prepare.mjs +2 -0
- package/dist/cli/commands/public.mjs +3 -0
- package/dist/cli/commands/resolve.mjs +23 -0
- package/dist/cli/commands/route.mjs +2 -0
- package/dist/cli/commands/runner.mjs +1 -0
- package/dist/cli/commands/scan.mjs +2 -0
- package/dist/cli/commands/setup.mjs +34 -0
- package/dist/cli/commands/sign.mjs +4 -0
- package/dist/cli/commands/signer.mjs +1 -0
- package/dist/cli/commands/swap.mjs +36 -0
- package/dist/cli/commands/upgrade.mjs +2 -0
- package/dist/cli/commands/vault.mjs +1 -0
- package/dist/cli/commands/version.mjs +2 -0
- package/dist/data/desk-data.mjs +55 -0
- package/dist/data/names.mjs +2 -0
- package/dist/data/providers/farming.mjs +2 -0
- package/dist/equities/index.mjs +1 -0
- package/dist/index.mjs +60 -0
- package/dist/nft-gas-war-guard.mjs +1 -0
- package/dist/onboarding/harness-configs.mjs +4 -0
- package/dist/portfolio-risk.mjs +1 -0
- package/dist/prepare-envelope.mjs +1 -0
- package/dist/public-api/agent-grants.mjs +3 -0
- package/dist/public-control/policy-schema.mjs +1 -0
- package/dist/router/index.mjs +2 -0
- package/dist/scanner/index.mjs +4 -0
- package/dist/signals/index.mjs +1 -0
- package/dist/watch-preferences.mjs +1 -0
- package/package.json +32 -78
- package/public/oracle-splash/_variants/ice.html +5 -18
- package/public/oracle-splash/_variants/ivory.html +5 -18
- package/public/oracle-splash/index.html +114 -34
- package/CONTRIBUTING.md +0 -99
- package/bin/desk-server.mjs +0 -473
- package/bin/oracle-data-mcp.mjs +0 -1252
- package/bin/oracle-equities.mjs +0 -168
- package/bin/oracle-init.mjs +0 -525
- package/bin/oracle-public-server.mjs +0 -36
- package/bin/oracle-route.mjs +0 -254
- package/bin/oracle-scan.mjs +0 -192
- package/bin/oracle-upgrade.mjs +0 -42
- package/bin/oracle.mjs +0 -34
- package/docs/adding-a-chain.md +0 -229
- package/docs/architecture.md +0 -139
- package/docs/buzz-integration.md +0 -115
- package/docs/cli.md +0 -143
- package/docs/connectors.md +0 -13
- package/docs/hyperliquid-builder-code.md +0 -50
- package/docs/locals-only-fee-waiver.md +0 -34
- package/docs/oracle-pack-standard.md +0 -29
- package/docs/profiles.md +0 -151
- package/docs/public-surface.md +0 -206
- package/examples/add-a-chain.mjs +0 -65
- package/examples/oracle-pack-template.mjs +0 -38
- package/examples/research-a-token.mjs +0 -70
- package/plugins/oracle-owner-gate/__init__.py +0 -288
- package/plugins/oracle-owner-gate/plugin.yaml +0 -9
- package/protocols/templates/safe-erc20/SECURITY.md +0 -16
- package/protocols/templates/safe-erc20/foundry.toml +0 -12
- package/protocols/templates/safe-erc20/remappings.txt +0 -2
- package/protocols/templates/safe-erc20/src/SafeERC20.sol +0 -53
- package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +0 -72
- package/scripts/adversarial-bench.mjs +0 -114
- package/scripts/build-dist.mjs +0 -119
- package/scripts/build-inscription.py +0 -230
- package/scripts/check-doc-drift.mjs +0 -123
- package/scripts/check-test-count.mjs +0 -105
- package/scripts/e2e-hl-markets.mjs +0 -21
- package/scripts/e2e-hl-perps.mjs +0 -48
- package/scripts/e2e-hypercore-staking.mjs +0 -128
- package/scripts/e2e-solana-bitcoin.mjs +0 -183
- package/scripts/guard-publish.mjs +0 -22
- package/scripts/protocol-template-gate.mjs +0 -15
- package/scripts/public-api-scan.mjs +0 -23
- package/scripts/publish-dist.mjs +0 -67
- package/scripts/record-hero-cli.sh +0 -80
- package/scripts/secret-scan.mjs +0 -169
- package/scripts/smoke-dist-bins.mjs +0 -89
- package/scripts/verify-dist.mjs +0 -29
- package/scripts/verify-v3-venues.mjs +0 -233
- package/skins/oracle.yaml +0 -56
- package/src/action-receipts.mjs +0 -265
- package/src/action-semantics.mjs +0 -62
- package/src/address-book.mjs +0 -208
- package/src/agent-auth.mjs +0 -206
- package/src/approval-guard.mjs +0 -282
- package/src/attestation-secret.mjs +0 -94
- package/src/audit-log.mjs +0 -196
- package/src/auth/oauth.mjs +0 -672
- package/src/auto-slippage.mjs +0 -378
- package/src/capability-posture.mjs +0 -125
- package/src/cards.mjs +0 -422
- package/src/chains.mjs +0 -62
- package/src/cli/chain-catalog.mjs +0 -215
- package/src/cli/chain-state.mjs +0 -74
- package/src/cli/commands/auth.mjs +0 -193
- package/src/cli/commands/bootstrap.mjs +0 -87
- package/src/cli/commands/chain.mjs +0 -143
- package/src/cli/commands/chat.mjs +0 -465
- package/src/cli/commands/credential.mjs +0 -9
- package/src/cli/commands/data-mcp.mjs +0 -18
- package/src/cli/commands/data.mjs +0 -75
- package/src/cli/commands/doctor.mjs +0 -136
- package/src/cli/commands/equities.mjs +0 -41
- package/src/cli/commands/farm.mjs +0 -129
- package/src/cli/commands/fees.mjs +0 -109
- package/src/cli/commands/follow.mjs +0 -130
- package/src/cli/commands/harness.mjs +0 -63
- package/src/cli/commands/help.mjs +0 -7
- package/src/cli/commands/init.mjs +0 -27
- package/src/cli/commands/mcp.mjs +0 -154
- package/src/cli/commands/model.mjs +0 -106
- package/src/cli/commands/plugins.mjs +0 -275
- package/src/cli/commands/prepare.mjs +0 -12
- package/src/cli/commands/public.mjs +0 -20
- package/src/cli/commands/resolve.mjs +0 -64
- package/src/cli/commands/route.mjs +0 -12
- package/src/cli/commands/runner.mjs +0 -9
- package/src/cli/commands/scan.mjs +0 -12
- package/src/cli/commands/setup.mjs +0 -294
- package/src/cli/commands/sign.mjs +0 -21
- package/src/cli/commands/signer.mjs +0 -9
- package/src/cli/commands/swap.mjs +0 -102
- package/src/cli/commands/upgrade.mjs +0 -12
- package/src/cli/commands/vault.mjs +0 -9
- package/src/cli/commands/version.mjs +0 -22
- package/src/cli/first-run.mjs +0 -23
- package/src/cli/kernel.mjs +0 -262
- package/src/cli/mcp-targets/chatgpt.mjs +0 -51
- package/src/cli/mcp-targets/claude-code.mjs +0 -39
- package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
- package/src/cli/mcp-targets/codex.mjs +0 -41
- package/src/cli/mcp-targets/cursor.mjs +0 -32
- package/src/cli/mcp-targets/shared.mjs +0 -71
- package/src/cli/mcp-targets/vscode.mjs +0 -39
- package/src/cli/messaging-platforms.mjs +0 -217
- package/src/cli/model-config.mjs +0 -78
- package/src/cli/operator-dispatch.mjs +0 -194
- package/src/cli/oracle-harness.py +0 -415
- package/src/cli/paths.mjs +0 -107
- package/src/cli/runtime.mjs +0 -351
- package/src/cli/setup-state.mjs +0 -168
- package/src/cli/spawn-child.mjs +0 -43
- package/src/data/catalog.mjs +0 -858
- package/src/data/desk-data.mjs +0 -877
- package/src/data/http.mjs +0 -253
- package/src/data/names.mjs +0 -188
- package/src/data/provider-endpoint.mjs +0 -94
- package/src/data/providers/aave-v3.mjs +0 -139
- package/src/data/providers/across-bridge.mjs +0 -41
- package/src/data/providers/aerodrome.mjs +0 -245
- package/src/data/providers/aevo.mjs +0 -33
- package/src/data/providers/approval-indexer.mjs +0 -133
- package/src/data/providers/approvals.mjs +0 -594
- package/src/data/providers/babylon-staking.mjs +0 -149
- package/src/data/providers/balancer.mjs +0 -209
- package/src/data/providers/beefy-yields.mjs +0 -45
- package/src/data/providers/birdeye-tokens.mjs +0 -33
- package/src/data/providers/bisq-markets.mjs +0 -145
- package/src/data/providers/bitcoin-esplora.mjs +0 -216
- package/src/data/providers/bitcoin-meta.mjs +0 -378
- package/src/data/providers/blockscout.mjs +0 -14
- package/src/data/providers/bob-rootstock.mjs +0 -198
- package/src/data/providers/braiins-insights.mjs +0 -103
- package/src/data/providers/bridge-aggregator.mjs +0 -259
- package/src/data/providers/bridges.mjs +0 -242
- package/src/data/providers/bungee.mjs +0 -29
- package/src/data/providers/celestia-da.mjs +0 -38
- package/src/data/providers/changenow.mjs +0 -135
- package/src/data/providers/compound.mjs +0 -32
- package/src/data/providers/connext.mjs +0 -28
- package/src/data/providers/convex.mjs +0 -30
- package/src/data/providers/cow-protocol.mjs +0 -110
- package/src/data/providers/cowswap.mjs +0 -415
- package/src/data/providers/curve.mjs +0 -201
- package/src/data/providers/das-assets.mjs +0 -59
- package/src/data/providers/debridge.mjs +0 -109
- package/src/data/providers/defillama.mjs +0 -88
- package/src/data/providers/dexscreener.mjs +0 -43
- package/src/data/providers/drift.mjs +0 -32
- package/src/data/providers/dydx.mjs +0 -41
- package/src/data/providers/evm-rpc.mjs +0 -225
- package/src/data/providers/farming.mjs +0 -291
- package/src/data/providers/geckoterminal.mjs +0 -34
- package/src/data/providers/gmx.mjs +0 -496
- package/src/data/providers/hiro-stacks.mjs +0 -150
- package/src/data/providers/hl-assets.mjs +0 -165
- package/src/data/providers/hl-info.mjs +0 -108
- package/src/data/providers/hl-markets.mjs +0 -210
- package/src/data/providers/hl-outcome.mjs +0 -61
- package/src/data/providers/hl-perps.mjs +0 -419
- package/src/data/providers/hl-staking.mjs +0 -353
- package/src/data/providers/hl-ws.mjs +0 -119
- package/src/data/providers/hyperevm-dex.mjs +0 -49
- package/src/data/providers/jito-mev.mjs +0 -117
- package/src/data/providers/jupiter-venues.mjs +0 -119
- package/src/data/providers/jupiter.mjs +0 -315
- package/src/data/providers/kamino-strategies.mjs +0 -143
- package/src/data/providers/l2beat-tvl.mjs +0 -42
- package/src/data/providers/lifi.mjs +0 -166
- package/src/data/providers/liquid-esplora.mjs +0 -152
- package/src/data/providers/magiceden-ordinals.mjs +0 -141
- package/src/data/providers/magiceden-sol.mjs +0 -406
- package/src/data/providers/mempool-lightning.mjs +0 -144
- package/src/data/providers/mempool-mining.mjs +0 -142
- package/src/data/providers/meteora-dlmm.mjs +0 -168
- package/src/data/providers/morpho.mjs +0 -177
- package/src/data/providers/nft-gallery.mjs +0 -163
- package/src/data/providers/nft-portfolio.mjs +0 -494
- package/src/data/providers/odos.mjs +0 -156
- package/src/data/providers/ondo.mjs +0 -31
- package/src/data/providers/oneinch.mjs +0 -174
- package/src/data/providers/opensea-multichain.mjs +0 -136
- package/src/data/providers/opensea-nft.mjs +0 -371
- package/src/data/providers/orca.mjs +0 -29
- package/src/data/providers/ordinals-runes.mjs +0 -180
- package/src/data/providers/pancakeswap.mjs +0 -28
- package/src/data/providers/paraswap.mjs +0 -125
- package/src/data/providers/pendle.mjs +0 -188
- package/src/data/providers/poly-clob.mjs +0 -283
- package/src/data/providers/poly-public.mjs +0 -96
- package/src/data/providers/poly-ws.mjs +0 -103
- package/src/data/providers/polygon-staking.mjs +0 -227
- package/src/data/providers/portfolio-history.mjs +0 -394
- package/src/data/providers/portfolio.mjs +0 -600
- package/src/data/providers/pyth-price-feeds.mjs +0 -172
- package/src/data/providers/raydium.mjs +0 -35
- package/src/data/providers/relayscan-mev.mjs +0 -72
- package/src/data/providers/rfq.mjs +0 -15
- package/src/data/providers/rh-agent.mjs +0 -59
- package/src/data/providers/sanctum-lst.mjs +0 -180
- package/src/data/providers/satflow.mjs +0 -341
- package/src/data/providers/signed-material-guard.mjs +0 -108
- package/src/data/providers/solana-rpc.mjs +0 -197
- package/src/data/providers/solend-lending.mjs +0 -166
- package/src/data/providers/spark-lend.mjs +0 -42
- package/src/data/providers/squid-router.mjs +0 -29
- package/src/data/providers/stargate.mjs +0 -29
- package/src/data/providers/sushiswap.mjs +0 -30
- package/src/data/providers/symbiotic-restaking.mjs +0 -41
- package/src/data/providers/thorchain.mjs +0 -36
- package/src/data/providers/traderjoe.mjs +0 -28
- package/src/data/providers/twap.mjs +0 -152
- package/src/data/providers/uniswap-v3.mjs +0 -457
- package/src/data/providers/uniswap-v4.mjs +0 -414
- package/src/data/providers/vertex.mjs +0 -41
- package/src/data/providers/wallet-watch.mjs +0 -264
- package/src/data/providers/wormhole.mjs +0 -28
- package/src/data/providers/yearn.mjs +0 -31
- package/src/data/providers/zerox.mjs +0 -167
- package/src/data/public-api-scan.mjs +0 -61
- package/src/data/quote-placeholder.mjs +0 -31
- package/src/desk/swap-prepare.mjs +0 -194
- package/src/equities/bridge.mjs +0 -388
- package/src/equities/fixtures/bridge_routes.json +0 -159
- package/src/equities/fixtures/dst_transitions.json +0 -29
- package/src/equities/fixtures/equity_dex_pools.json +0 -154
- package/src/equities/fixtures/hip3_l2books.json +0 -2711
- package/src/equities/fixtures/nyse_holidays.json +0 -1
- package/src/equities/fixtures/oracles.json +0 -100
- package/src/equities/fixtures/rh_pool_state.json +0 -244
- package/src/equities/fixtures/solana_xstocks.json +0 -704
- package/src/equities/fixtures/ton_xstocks.json +0 -35
- package/src/equities/fixtures/universe.json +0 -411
- package/src/equities/fixtures/venues.json +0 -3542
- package/src/equities/fixtures.mjs +0 -405
- package/src/equities/funding.mjs +0 -142
- package/src/equities/index.mjs +0 -166
- package/src/equities/liveness.mjs +0 -148
- package/src/equities/marketHours.mjs +0 -249
- package/src/equities/normalize.mjs +0 -295
- package/src/equities/num.mjs +0 -146
- package/src/equities/prepare.mjs +0 -95
- package/src/equities/rank.mjs +0 -260
- package/src/equities/sourceNum.mjs +0 -69
- package/src/equities/types.mjs +0 -220
- package/src/equities/venues/arcus-perp.mjs +0 -84
- package/src/equities/venues/arcus-spot.mjs +0 -105
- package/src/equities/venues/hyperliquid-hip3.mjs +0 -224
- package/src/equities/venues/rh-uniswap.mjs +0 -216
- package/src/equities/venues/solana-xstocks.mjs +0 -139
- package/src/equities/venues/ton-stonfi.mjs +0 -139
- package/src/exact-integer.mjs +0 -72
- package/src/exec-policy.mjs +0 -419
- package/src/flags.mjs +0 -15
- package/src/fresh-window.mjs +0 -76
- package/src/gmx-attestation.mjs +0 -176
- package/src/index.mjs +0 -107
- package/src/licensing/locals-only.mjs +0 -25
- package/src/nft-gas-war-guard.mjs +0 -139
- package/src/onboarding/agent-keys.mjs +0 -161
- package/src/onboarding/harness-configs.mjs +0 -102
- package/src/onboarding/index.mjs +0 -18
- package/src/onboarding/tiers.mjs +0 -139
- package/src/oracle-env.mjs +0 -55
- package/src/package-manifest.mjs +0 -42
- package/src/plugins/agent-plugin-loader.mjs +0 -225
- package/src/portfolio-risk.mjs +0 -170
- package/src/prepare-envelope.mjs +0 -204
- package/src/profile-upgrade.mjs +0 -277
- package/src/protocol-execution.mjs +0 -84
- package/src/protocol-templates/gate.mjs +0 -179
- package/src/protocol-templates/prepare-deploy.mjs +0 -81
- package/src/public-api/agent-grants.mjs +0 -57
- package/src/public-api/buzz-integration.mjs +0 -267
- package/src/public-api/connect-agent.mjs +0 -424
- package/src/public-api/grants.mjs +0 -142
- package/src/public-api/http.mjs +0 -707
- package/src/public-api/metering.mjs +0 -111
- package/src/public-control/aa-adapter.mjs +0 -402
- package/src/public-control/build-registry.mjs +0 -227
- package/src/public-control/bundler-client.mjs +0 -357
- package/src/public-control/grant-indexer.mjs +0 -296
- package/src/public-control/policy-render.mjs +0 -69
- package/src/public-control/policy-schema.mjs +0 -322
- package/src/public-control/runtime-config.mjs +0 -275
- package/src/public-control/session-key-model.mjs +0 -379
- package/src/public-control/session-orchestrator.mjs +0 -418
- package/src/rfq/intent.mjs +0 -180
- package/src/rfq/sources.mjs +0 -181
- package/src/route-attestation.mjs +0 -132
- package/src/router/best-execution.mjs +0 -326
- package/src/router/index.mjs +0 -250
- package/src/router/integrator-fee.mjs +0 -135
- package/src/router/prepare-bridge.mjs +0 -293
- package/src/router/prepare-route.mjs +0 -398
- package/src/router/proposal.mjs +0 -311
- package/src/router/risk-classifier.mjs +0 -119
- package/src/router/route-sources.mjs +0 -364
- package/src/scanner/chains.config.mjs +0 -543
- package/src/scanner/contract.mjs +0 -270
- package/src/scanner/evm-scanner.mjs +0 -394
- package/src/scanner/index.mjs +0 -9
- package/src/scanner/v2-venue.mjs +0 -351
- package/src/scanner/v3-venue.mjs +0 -308
- package/src/scopes.mjs +0 -44
- package/src/sell-simulation.mjs +0 -167
- package/src/signals/engine.mjs +0 -146
- package/src/signals/index.mjs +0 -1
- package/src/token-transfer-guard.mjs +0 -188
- package/src/tui/app.mjs +0 -438
- package/src/tui/backend.mjs +0 -215
- package/src/tui/format.mjs +0 -272
- package/src/tui/gateway-client.mjs +0 -177
- package/src/tui/input.mjs +0 -501
- package/src/tui/memory.mjs +0 -105
- package/src/tui/meta-learn.mjs +0 -85
- package/src/tui/renderer.mjs +0 -443
- package/src/tui/scheduler.mjs +0 -205
- package/src/tui/skills-loader.mjs +0 -140
- package/src/tui/standalone-client.mjs +0 -752
- package/src/tui/theme.mjs +0 -81
- package/src/vault-attestation.mjs +0 -146
- package/src/venues.mjs +0 -206
- package/src/watch-preferences.mjs +0 -85
- /package/{profiles → dist/assets/profiles}/_template/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/_template/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/bitcoin-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/bitcoin-agent/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/hyperliquid-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/hyperliquid-agent/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/oracle/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/oracle/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/polymarket-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/polymarket-agent/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/profile.schema.json +0 -0
- /package/{profiles → dist/assets/profiles}/protocol-builder/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/protocol-builder/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/robinhood-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/robinhood-agent/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/solana-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/solana-agent/profile.json +0 -0
- /package/{profiles → dist/assets/profiles}/stable-agent/SOUL.md +0 -0
- /package/{profiles → dist/assets/profiles}/stable-agent/profile.json +0 -0
- /package/{skills → dist/assets/skills}/balance/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/bitcoin-l1.md +0 -0
- /package/{skills → dist/assets/skills}/chain-defi-ecosystem-profiling.md +0 -0
- /package/{skills → dist/assets/skills}/evm-contract-research.md +0 -0
- /package/{skills → dist/assets/skills}/hyperliquid.md +0 -0
- /package/{skills → dist/assets/skills}/multichain-exec-desk.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-action-semantics/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-best-execution/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-best-execution.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-bitcoin/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-chain-graphs-telegram-cards/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-chat/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-chat/chain.SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-chat/setup.SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-circuit-breaker/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-contract-research/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-desk/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-desk.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-dex-launch/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-equities/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-grants/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-hypercore-staking/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-hyperliquid/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-meme-token-sniper/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-multichain-nft-launch/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-multichain-token-launch/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-nft-gacha-launch/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-nft-mint-gas-war/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-polymarket/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-protocol-builder/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-protocol-security/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-public-product/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-receipts/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-receipts.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-rfq-tokenized-assets/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-smart-wallet-scanner/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-solana/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-solana-nft/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/oracle-token-research/SKILL.md +0 -0
- /package/{skills → dist/assets/skills}/solana.md +0 -0
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
// Solana venue labels routed through the Jupiter aggregator provider.
|
|
2
|
-
//
|
|
3
|
-
// Preserved as source data on 2026-08-03: this roster previously existed only
|
|
4
|
-
// as markup in the splash page, so deleting that markup silently deleted the
|
|
5
|
-
// evidence behind the README/site claim. Data belongs in src/, not in a
|
|
6
|
-
// presentation layer that a redesign can drop.
|
|
7
|
-
//
|
|
8
|
-
// 101 program labels resolving to 98 unique venue brands: Aldrin/Aldrin V2,
|
|
9
|
-
// Orca V1/Orca V2, and SolFi/SolFi V2 are version variants of one venue.
|
|
10
|
-
|
|
11
|
-
export const JUPITER_VENUE_LABELS = Object.freeze([
|
|
12
|
-
"1DEX",
|
|
13
|
-
"Aldrin",
|
|
14
|
-
"Aldrin V2",
|
|
15
|
-
"AlphaQ",
|
|
16
|
-
"Aquifer",
|
|
17
|
-
"BinaryFi",
|
|
18
|
-
"BisonFi",
|
|
19
|
-
"BisonFi Predict",
|
|
20
|
-
"Bonkswap",
|
|
21
|
-
"Boop.fun",
|
|
22
|
-
"Byreal",
|
|
23
|
-
"Carrot",
|
|
24
|
-
"Crema",
|
|
25
|
-
"Cropper",
|
|
26
|
-
"customizable",
|
|
27
|
-
"DefiTuna",
|
|
28
|
-
"Denali",
|
|
29
|
-
"Deriverse",
|
|
30
|
-
"DexLab",
|
|
31
|
-
"Dynamic Bonding Curve",
|
|
32
|
-
"Flint",
|
|
33
|
-
"Flux",
|
|
34
|
-
"FluxBeam",
|
|
35
|
-
"GatorSwap",
|
|
36
|
-
"Gavel",
|
|
37
|
-
"GoonFi V2",
|
|
38
|
-
"GooseFX GAMMA",
|
|
39
|
-
"Guacswap",
|
|
40
|
-
"Hadron",
|
|
41
|
-
"Heaven",
|
|
42
|
-
"Helium Network",
|
|
43
|
-
"Huma",
|
|
44
|
-
"HumidiFi",
|
|
45
|
-
"Hylo Exchange",
|
|
46
|
-
"Hylo Stability Pool",
|
|
47
|
-
"Invariant",
|
|
48
|
-
"Jupiter Lend Earn",
|
|
49
|
-
"JupiterRfqV2",
|
|
50
|
-
"JupLend AMM",
|
|
51
|
-
"Kipseli",
|
|
52
|
-
"LemmingsFi",
|
|
53
|
-
"Manifest",
|
|
54
|
-
"Mercurial",
|
|
55
|
-
"MetaDAO",
|
|
56
|
-
"Meteora",
|
|
57
|
-
"Meteora DAMM v2",
|
|
58
|
-
"Meteora DLMM",
|
|
59
|
-
"Metric",
|
|
60
|
-
"Moonit",
|
|
61
|
-
"more chains",
|
|
62
|
-
"M Swap",
|
|
63
|
-
"Obric V2",
|
|
64
|
-
"Obsidian",
|
|
65
|
-
"Omnipair",
|
|
66
|
-
"OpenBook V2",
|
|
67
|
-
"Orca V1",
|
|
68
|
-
"Orca V2",
|
|
69
|
-
"PancakeSwap",
|
|
70
|
-
"Penguin",
|
|
71
|
-
"Perena",
|
|
72
|
-
"Perena Star",
|
|
73
|
-
"Perps",
|
|
74
|
-
"Phoenix",
|
|
75
|
-
"protocol builder",
|
|
76
|
-
"Pump.fun",
|
|
77
|
-
"Pump.fun Amm",
|
|
78
|
-
"Quantum",
|
|
79
|
-
"Raydium",
|
|
80
|
-
"Raydium CLMM",
|
|
81
|
-
"Raydium CP",
|
|
82
|
-
"Raydium Launchlab",
|
|
83
|
-
"Riptide",
|
|
84
|
-
"RunnerRodeo",
|
|
85
|
-
"Saber",
|
|
86
|
-
"Saber (Decimals)",
|
|
87
|
-
"Sanctum",
|
|
88
|
-
"Sanctum Infinity",
|
|
89
|
-
"Saros",
|
|
90
|
-
"Saros DLMM",
|
|
91
|
-
"Scale Amm",
|
|
92
|
-
"Scale Vmm",
|
|
93
|
-
"Scorch",
|
|
94
|
-
"Solayer",
|
|
95
|
-
"SolFi",
|
|
96
|
-
"SolFi V2",
|
|
97
|
-
"Stabble CLMM",
|
|
98
|
-
"Stabble Stable Swap",
|
|
99
|
-
"Stabble Weighted Swap",
|
|
100
|
-
"StepN",
|
|
101
|
-
"TaurusFi",
|
|
102
|
-
"TesseraV",
|
|
103
|
-
"Token Swap",
|
|
104
|
-
"Trends",
|
|
105
|
-
"VaultLiquidUnstake",
|
|
106
|
-
"Virtuals",
|
|
107
|
-
"Voltr",
|
|
108
|
-
"WhaleStreet",
|
|
109
|
-
"Whirlpool",
|
|
110
|
-
"Woofi",
|
|
111
|
-
"XOrca",
|
|
112
|
-
"ZeroFi"
|
|
113
|
-
]);
|
|
114
|
-
|
|
115
|
-
/** Unique venue brands, collapsing version variants. */
|
|
116
|
-
export function uniqueVenueBrands() {
|
|
117
|
-
const norm = (s) => s.toLowerCase().replace(/\s+v[0-9]+$/, "").replace(/[^a-z0-9]/g, "");
|
|
118
|
-
return new Set(JUPITER_VENUE_LABELS.map(norm));
|
|
119
|
-
}
|
|
@@ -1,315 +0,0 @@
|
|
|
1
|
-
// Jupiter Swap API lane for Solana. Prepare-only: returns a serialized
|
|
2
|
-
// transaction for the user's Solana wallet to sign. No local signer, no broadcast.
|
|
3
|
-
|
|
4
|
-
import { httpJson } from "../http.mjs";
|
|
5
|
-
import { solanaPubkey } from "./solana-rpc.mjs";
|
|
6
|
-
import { stampPrepared } from "../../prepare-envelope.mjs";
|
|
7
|
-
import { assertNoSignedMaterial } from "./signed-material-guard.mjs";
|
|
8
|
-
|
|
9
|
-
export const JUPITER_SWAP_API = "https://lite-api.jup.ag/swap/v1";
|
|
10
|
-
export const SOL_MINT = "So11111111111111111111111111111111111111112";
|
|
11
|
-
export const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
|
|
12
|
-
export const JUPITER_MAX_SLIPPAGE_BPS = 100;
|
|
13
|
-
const DEFAULT_QUOTE_TTL_MS = 20_000;
|
|
14
|
-
|
|
15
|
-
function baseUrl(opts = {}) {
|
|
16
|
-
return String(opts.baseUrl || process.env.JUPITER_SWAP_API_URL || JUPITER_SWAP_API).replace(/\/$/, "");
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
function amountString(value, label = "amount") {
|
|
20
|
-
try {
|
|
21
|
-
const n = BigInt(String(value));
|
|
22
|
-
if (n <= 0n) throw new Error("nonpositive");
|
|
23
|
-
return n.toString();
|
|
24
|
-
} catch {
|
|
25
|
-
throw new Error(`jupiter: ${label} must be a positive integer string`);
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
function slippageBps(value) {
|
|
30
|
-
const n = value == null ? 50 : Number(value);
|
|
31
|
-
if (!Number.isInteger(n) || n < 0) throw new Error("jupiter: slippageBps must be a non-negative integer");
|
|
32
|
-
if (n > JUPITER_MAX_SLIPPAGE_BPS) throw new Error("jupiter: slippage exceeds hard 100 bps cap");
|
|
33
|
-
return n;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
function boolDefault(value, fallback) {
|
|
37
|
-
return value == null ? fallback : Boolean(value);
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
function base64Tx(value) {
|
|
41
|
-
const text = String(value || "").trim();
|
|
42
|
-
if (!/^[A-Za-z0-9+/]+={0,2}$/.test(text) || text.length % 4 !== 0) throw new Error("jupiter: swapTransaction must be base64");
|
|
43
|
-
return text;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
function solanaGuard(quote = {}, { quotedAtMs = Date.now(), ttlMs = DEFAULT_QUOTE_TTL_MS } = {}) {
|
|
47
|
-
const inputMint = solanaPubkey(quote.inputMint, "inputMint");
|
|
48
|
-
const outputMint = solanaPubkey(quote.outputMint, "outputMint");
|
|
49
|
-
const inAmount = amountString(quote.inAmount, "inAmount");
|
|
50
|
-
const outAmount = amountString(quote.outAmount, "outAmount");
|
|
51
|
-
const otherAmountThreshold = amountString(quote.otherAmountThreshold ?? quote.outAmount, "otherAmountThreshold");
|
|
52
|
-
const bps = slippageBps(quote.slippageBps ?? 50);
|
|
53
|
-
return {
|
|
54
|
-
mode: "solana-jupiter-quote",
|
|
55
|
-
provider: "jupiter",
|
|
56
|
-
venue: "jupiter-swap-v1",
|
|
57
|
-
inputMint,
|
|
58
|
-
outputMint,
|
|
59
|
-
inAmount,
|
|
60
|
-
outAmount,
|
|
61
|
-
otherAmountThreshold,
|
|
62
|
-
slippageBps: bps,
|
|
63
|
-
contextSlot: quote.contextSlot ?? null,
|
|
64
|
-
quotedAtMs,
|
|
65
|
-
expiresAtMs: quotedAtMs + Math.min(Math.max(Number(ttlMs) || DEFAULT_QUOTE_TTL_MS, 1_000), 30_000),
|
|
66
|
-
};
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
// Known BPF loaders. A program is only real if it is BOTH executable AND owned
|
|
70
|
-
// by one of these. `executable: true` alone is claimable by any account, so
|
|
71
|
-
// checking it in isolation is not proof.
|
|
72
|
-
const SOLANA_LOADERS = new Set([
|
|
73
|
-
"BPFLoaderUpgradeab1e11111111111111111111111",
|
|
74
|
-
"BPFLoader2111111111111111111111111111111111",
|
|
75
|
-
"BPFLoader1111111111111111111111111111111111",
|
|
76
|
-
]);
|
|
77
|
-
|
|
78
|
-
const B58_ALPHA = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
|
|
79
|
-
|
|
80
|
-
function isSolanaPubkey(s) {
|
|
81
|
-
if (typeof s !== "string" || !s.length) return false;
|
|
82
|
-
let num = 0n;
|
|
83
|
-
for (const ch of s) {
|
|
84
|
-
const v = B58_ALPHA.indexOf(ch);
|
|
85
|
-
if (v < 0) return false;
|
|
86
|
-
num = num * 58n + BigInt(v);
|
|
87
|
-
}
|
|
88
|
-
let hex = num.toString(16);
|
|
89
|
-
if (hex.length % 2) hex = "0" + hex;
|
|
90
|
-
let bytes = hex.length / 2;
|
|
91
|
-
for (const ch of s) {
|
|
92
|
-
if (ch === "1") bytes++;
|
|
93
|
-
else break;
|
|
94
|
-
}
|
|
95
|
-
return bytes === 32;
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
export async function jupiterVenues(args = {}, opts = {}) {
|
|
99
|
-
const rpcUrl = args.rpc || opts.solanaRpc || process.env.SOLANA_RPC || "https://api.mainnet-beta.solana.com";
|
|
100
|
-
const fetchImpl = opts.fetchImpl || fetch;
|
|
101
|
-
|
|
102
|
-
const res = await fetchImpl(`${JUPITER_SWAP_API}/program-id-to-label`, {
|
|
103
|
-
signal: AbortSignal.timeout(Number(opts.timeoutMs) || 15_000),
|
|
104
|
-
});
|
|
105
|
-
if (!res.ok) throw new Error(`jupiter venue map failed: HTTP ${res.status}`);
|
|
106
|
-
const labelMap = await res.json();
|
|
107
|
-
|
|
108
|
-
const entries = Object.entries(labelMap);
|
|
109
|
-
const wellFormed = entries.filter(([id]) => isSolanaPubkey(id));
|
|
110
|
-
const verified = [];
|
|
111
|
-
const unresolved = entries
|
|
112
|
-
.filter(([id]) => !isSolanaPubkey(id))
|
|
113
|
-
.map(([id, label]) => ({ programId: id, label, reason: "malformed program id" }));
|
|
114
|
-
|
|
115
|
-
if (args.verify === false) {
|
|
116
|
-
return {
|
|
117
|
-
source: `${JUPITER_SWAP_API}/program-id-to-label`,
|
|
118
|
-
verified: wellFormed.map(([programId, label]) => ({ programId, label })),
|
|
119
|
-
unresolved,
|
|
120
|
-
verifiedOnChain: false,
|
|
121
|
-
totals: { fromRouterMap: entries.length, verified: wellFormed.length },
|
|
122
|
-
};
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
const call = async (body) => {
|
|
126
|
-
const r = await fetchImpl(rpcUrl, {
|
|
127
|
-
method: "POST",
|
|
128
|
-
headers: { "content-type": "application/json" },
|
|
129
|
-
body: JSON.stringify(body),
|
|
130
|
-
signal: AbortSignal.timeout(Number(opts.timeoutMs) || 20_000),
|
|
131
|
-
});
|
|
132
|
-
const j = await r.json();
|
|
133
|
-
if (j.error) throw new Error(j.error.message);
|
|
134
|
-
return j.result;
|
|
135
|
-
};
|
|
136
|
-
|
|
137
|
-
for (let i = 0; i < wellFormed.length; i += 90) {
|
|
138
|
-
const chunk = wellFormed.slice(i, i + 90);
|
|
139
|
-
let out = null;
|
|
140
|
-
for (let attempt = 0; attempt < 3 && !out; attempt++) {
|
|
141
|
-
try {
|
|
142
|
-
out = await call({
|
|
143
|
-
jsonrpc: "2.0",
|
|
144
|
-
id: 1,
|
|
145
|
-
method: "getMultipleAccounts",
|
|
146
|
-
params: [chunk.map(([id]) => id), { encoding: "base64", dataSlice: { offset: 0, length: 0 } }],
|
|
147
|
-
});
|
|
148
|
-
} catch {
|
|
149
|
-
await new Promise((r) => setTimeout(r, 2000 * (attempt + 1)));
|
|
150
|
-
}
|
|
151
|
-
}
|
|
152
|
-
if (!out) {
|
|
153
|
-
for (const [programId, label] of chunk) {
|
|
154
|
-
unresolved.push({ programId, label, reason: "rpc batch failed after 3 attempts" });
|
|
155
|
-
}
|
|
156
|
-
continue;
|
|
157
|
-
}
|
|
158
|
-
out.value.forEach((acc, k) => {
|
|
159
|
-
const [programId, label] = chunk[k];
|
|
160
|
-
if (acc && acc.executable === true && SOLANA_LOADERS.has(acc.owner)) {
|
|
161
|
-
verified.push({ programId, label, owner: acc.owner });
|
|
162
|
-
} else {
|
|
163
|
-
unresolved.push({
|
|
164
|
-
programId,
|
|
165
|
-
label,
|
|
166
|
-
reason: !acc ? "account not found" : acc.executable !== true ? "not executable" : `unknown owner ${acc.owner}`,
|
|
167
|
-
});
|
|
168
|
-
}
|
|
169
|
-
});
|
|
170
|
-
if (i + 90 < wellFormed.length) await new Promise((r) => setTimeout(r, 700));
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
const brands = new Set(
|
|
174
|
-
verified.map((v) => v.label.replace(/\s+(CLMM|CP|V\d+|Launchlab|DLMM|Pools?)$/i, "").trim())
|
|
175
|
-
);
|
|
176
|
-
|
|
177
|
-
return {
|
|
178
|
-
source: `${JUPITER_SWAP_API}/program-id-to-label`,
|
|
179
|
-
rpc: rpcUrl,
|
|
180
|
-
verifiedOnChain: true,
|
|
181
|
-
verifiedAt: new Date().toISOString(),
|
|
182
|
-
totals: {
|
|
183
|
-
fromRouterMap: entries.length,
|
|
184
|
-
verified: verified.length,
|
|
185
|
-
unresolved: unresolved.length,
|
|
186
|
-
distinctLabels: new Set(verified.map((v) => v.label)).size,
|
|
187
|
-
distinctBrands: brands.size,
|
|
188
|
-
},
|
|
189
|
-
verified: verified.sort((a, b) => a.label.localeCompare(b.label)),
|
|
190
|
-
unresolved,
|
|
191
|
-
};
|
|
192
|
-
}
|
|
193
|
-
|
|
194
|
-
export async function jupiterHealth(opts = {}) {
|
|
195
|
-
try {
|
|
196
|
-
const q = await jupiterQuote({ inputMint: SOL_MINT, outputMint: USDC_MINT, amount: "1000000", slippageBps: 50 }, opts);
|
|
197
|
-
return { ok: true, provider: "jupiter", outAmount: q.quote.outAmount, exec: false };
|
|
198
|
-
} catch (error) {
|
|
199
|
-
return { ok: false, provider: "jupiter", error: String(error?.message || error), exec: false };
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
export async function jupiterQuote(args = {}, opts = {}) {
|
|
204
|
-
const inputMint = solanaPubkey(args.inputMint || args.fromMint || SOL_MINT, "inputMint");
|
|
205
|
-
const outputMint = solanaPubkey(args.outputMint || args.toMint || USDC_MINT, "outputMint");
|
|
206
|
-
const amount = amountString(args.amount || args.inAmount, "amount");
|
|
207
|
-
const bps = slippageBps(args.slippageBps ?? args.maxSlippageBps ?? 50);
|
|
208
|
-
const url = new URL(`${baseUrl(opts)}/quote`);
|
|
209
|
-
url.searchParams.set("inputMint", inputMint);
|
|
210
|
-
url.searchParams.set("outputMint", outputMint);
|
|
211
|
-
url.searchParams.set("amount", amount);
|
|
212
|
-
url.searchParams.set("slippageBps", String(bps));
|
|
213
|
-
url.searchParams.set("swapMode", args.swapMode || "ExactIn");
|
|
214
|
-
if (args.onlyDirectRoutes != null) url.searchParams.set("onlyDirectRoutes", String(Boolean(args.onlyDirectRoutes)));
|
|
215
|
-
if (args.platformFeeBps != null) url.searchParams.set("platformFeeBps", String(args.platformFeeBps));
|
|
216
|
-
const quote = await httpJson(url.toString(), {
|
|
217
|
-
fetchImpl: opts.fetchImpl,
|
|
218
|
-
timeoutMs: opts.timeoutMs ?? 12_000,
|
|
219
|
-
});
|
|
220
|
-
const guard = solanaGuard({ ...quote, slippageBps: bps }, opts);
|
|
221
|
-
return {
|
|
222
|
-
provider: "jupiter",
|
|
223
|
-
chain: "solana-mainnet-beta",
|
|
224
|
-
quoteReady: true,
|
|
225
|
-
executionReady: false,
|
|
226
|
-
inputMint,
|
|
227
|
-
outputMint,
|
|
228
|
-
amount,
|
|
229
|
-
quote,
|
|
230
|
-
solanaGuard: guard,
|
|
231
|
-
};
|
|
232
|
-
}
|
|
233
|
-
|
|
234
|
-
function compactBody(body) {
|
|
235
|
-
return Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined));
|
|
236
|
-
}
|
|
237
|
-
|
|
238
|
-
export async function jupiterPrepareSwap(args = {}, opts = {}) {
|
|
239
|
-
const userPublicKey = solanaPubkey(args.userPublicKey || args.owner || args.wallet, "userPublicKey");
|
|
240
|
-
const quoteEnvelope = args.quoteResponse
|
|
241
|
-
? { quote: args.quoteResponse, solanaGuard: solanaGuard(args.quoteResponse, opts) }
|
|
242
|
-
: await jupiterQuote(args, opts);
|
|
243
|
-
const quoteResponse = quoteEnvelope.quote;
|
|
244
|
-
const guard = quoteEnvelope.solanaGuard || solanaGuard(quoteResponse, opts);
|
|
245
|
-
|
|
246
|
-
// dynamicSlippage lets Jupiter widen the on-chain slippage floor at build
|
|
247
|
-
// time, which silently voids the hard bps ceiling the quote path enforced —
|
|
248
|
-
// the returned guard would still advertise the capped number. Refuse it
|
|
249
|
-
// rather than return a transaction whose real tolerance exceeds the cap.
|
|
250
|
-
if (boolDefault(args.dynamicSlippage, false) === true) {
|
|
251
|
-
throw new Error(
|
|
252
|
-
"jupiter: dynamicSlippage would override the enforced slippage ceiling — pass an explicit slippageBps instead"
|
|
253
|
-
);
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
const response = await httpJson(`${baseUrl(opts)}/swap`, {
|
|
257
|
-
method: "POST",
|
|
258
|
-
body: compactBody({
|
|
259
|
-
quoteResponse,
|
|
260
|
-
userPublicKey,
|
|
261
|
-
wrapAndUnwrapSol: boolDefault(args.wrapAndUnwrapSol, true),
|
|
262
|
-
dynamicComputeUnitLimit: boolDefault(args.dynamicComputeUnitLimit, true),
|
|
263
|
-
dynamicSlippage: false,
|
|
264
|
-
prioritizationFeeLamports: args.prioritizationFeeLamports,
|
|
265
|
-
}),
|
|
266
|
-
fetchImpl: opts.fetchImpl,
|
|
267
|
-
timeoutMs: opts.timeoutMs ?? 15_000,
|
|
268
|
-
});
|
|
269
|
-
const swapTransaction = base64Tx(response?.swapTransaction);
|
|
270
|
-
|
|
271
|
-
// Refuse pre-signed material by PRESENCE. The primary `swapTransaction` field
|
|
272
|
-
// stays unsigned, but the full upstream body was echoed as `raw` and
|
|
273
|
-
// hash-bound into the envelope, so a hostile endpoint could smuggle a signed
|
|
274
|
-
// sibling that downstream tooling might select instead.
|
|
275
|
-
assertNoSignedMaterial("jupiter", response);
|
|
276
|
-
|
|
277
|
-
// Bind the returned transaction to the quote it claims to implement. A
|
|
278
|
-
// compromised or impersonated endpoint can return any bytes while Oracle
|
|
279
|
-
// stamps the optimistic quote on top; the user signs the bytes, not the
|
|
280
|
-
// guard. Jupiter echoes the quote it built from — require it to match.
|
|
281
|
-
const echoed = response?.quoteResponse ?? response?.quote ?? null;
|
|
282
|
-
if (echoed) {
|
|
283
|
-
for (const field of ["inAmount", "outAmount", "otherAmountThreshold", "inputMint", "outputMint"]) {
|
|
284
|
-
const want = quoteResponse?.[field];
|
|
285
|
-
const got = echoed?.[field];
|
|
286
|
-
if (want != null && got != null && String(want) !== String(got)) {
|
|
287
|
-
throw new Error(
|
|
288
|
-
`jupiter: swap response ${field} (${got}) does not match the quoted ${field} (${want}) — refusing to prepare`
|
|
289
|
-
);
|
|
290
|
-
}
|
|
291
|
-
}
|
|
292
|
-
}
|
|
293
|
-
|
|
294
|
-
return stampPrepared({
|
|
295
|
-
provider: "jupiter",
|
|
296
|
-
chain: "solana-mainnet-beta",
|
|
297
|
-
prepareReady: true,
|
|
298
|
-
executionReady: false,
|
|
299
|
-
signingReady: false,
|
|
300
|
-
broadcastReady: false,
|
|
301
|
-
requiresUserSignature: true,
|
|
302
|
-
// The prepared bytes are NOT verified against the quote beyond the fields
|
|
303
|
-
// Jupiter echoes. Simulate before signing.
|
|
304
|
-
verifiedAgainstQuote: Boolean(echoed),
|
|
305
|
-
userPublicKey,
|
|
306
|
-
quote: quoteResponse,
|
|
307
|
-
solanaGuard: guard,
|
|
308
|
-
swapTransaction,
|
|
309
|
-
swapTransactionEncoding: "base64",
|
|
310
|
-
lastValidBlockHeight: response?.lastValidBlockHeight ?? null,
|
|
311
|
-
prioritizationFeeLamports: response?.prioritizationFeeLamports ?? null,
|
|
312
|
-
computeUnitLimit: response?.computeUnitLimit ?? null,
|
|
313
|
-
raw: response,
|
|
314
|
-
}, { provider: "jupiter", kind: "jupiter-swap" });
|
|
315
|
-
}
|
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
// Kamino Finance — Solana concentrated-liquidity vault strategies and APY.
|
|
2
|
-
//
|
|
3
|
-
// One upstream call returns metrics for every live strategy (500+), so this
|
|
4
|
-
// module fetches once and filters/sorts locally rather than issuing a request
|
|
5
|
-
// per strategy. Read-only: no deposit or withdraw preparation.
|
|
6
|
-
|
|
7
|
-
import { httpJson } from "../http.mjs";
|
|
8
|
-
|
|
9
|
-
export const KAMINO_API = "https://api.kamino.finance";
|
|
10
|
-
|
|
11
|
-
function base(opts = {}) {
|
|
12
|
-
return String(opts.baseUrl || process.env.KAMINO_API_URL || KAMINO_API).replace(/\/$/, "");
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
function num(value) {
|
|
16
|
-
const n = Number(value);
|
|
17
|
-
return Number.isFinite(n) ? n : null;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
function normalizeStrategy(entry = {}) {
|
|
21
|
-
const tvl = num(entry.totalValueLocked) ?? 0;
|
|
22
|
-
// Kamino splits yield: `apy` is trading fees + pool rewards, `kaminoApy` is
|
|
23
|
-
// the kToken incentive layer. Neither alone is the number a depositor earns.
|
|
24
|
-
const feeApy = num(entry.apy?.totalApy) ?? 0;
|
|
25
|
-
const rewardApy = num(entry.kaminoApy?.totalApy) ?? 0;
|
|
26
|
-
return {
|
|
27
|
-
strategy: entry.strategy || null,
|
|
28
|
-
pair: entry.tokenA && entry.tokenB ? `${entry.tokenA}-${entry.tokenB}` : null,
|
|
29
|
-
tokenA: entry.tokenA || null,
|
|
30
|
-
tokenB: entry.tokenB || null,
|
|
31
|
-
tokenAMint: entry.tokenAMint || null,
|
|
32
|
-
tokenBMint: entry.tokenBMint || null,
|
|
33
|
-
tvlUsd: tvl,
|
|
34
|
-
sharePrice: num(entry.sharePrice),
|
|
35
|
-
sharesIssued: num(entry.sharesIssued),
|
|
36
|
-
profitAndLoss: num(entry.profitAndLoss),
|
|
37
|
-
feeApy,
|
|
38
|
-
feeApyPct: feeApy * 100,
|
|
39
|
-
rewardApy,
|
|
40
|
-
rewardApyPct: rewardApy * 100,
|
|
41
|
-
totalApy: feeApy + rewardApy,
|
|
42
|
-
totalApyPct: (feeApy + rewardApy) * 100,
|
|
43
|
-
apr24h: num(entry.apy?.vault?.totalApr),
|
|
44
|
-
apy24h: num(entry.kaminoApy?.vault?.apy24h),
|
|
45
|
-
apy7d: num(entry.kaminoApy?.vault?.apy7d),
|
|
46
|
-
apy30d: num(entry.kaminoApy?.vault?.apy30d),
|
|
47
|
-
poolPrice: num(entry.apy?.vault?.poolPrice),
|
|
48
|
-
priceLower: num(entry.apy?.vault?.priceLower),
|
|
49
|
-
priceUpper: num(entry.apy?.vault?.priceUpper),
|
|
50
|
-
// A range-exited strategy has stopped earning fees — surface it loudly.
|
|
51
|
-
outOfRange: Boolean(entry.apy?.vault?.strategyOutOfRange),
|
|
52
|
-
rewardMints: entry.rewardMints || [],
|
|
53
|
-
balances: entry.vaultBalances || null,
|
|
54
|
-
lastCalculated: entry.kaminoApy?.vault?.lastCalculated || null,
|
|
55
|
-
};
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
async function fetchMetrics(args = {}, opts = {}) {
|
|
59
|
-
const url = new URL(`${base(opts)}/strategies/metrics`);
|
|
60
|
-
url.searchParams.set("env", String(args.env || "mainnet-beta"));
|
|
61
|
-
url.searchParams.set("status", String(args.status || "LIVE"));
|
|
62
|
-
const data = await httpJson(url.toString(), {
|
|
63
|
-
fetchImpl: opts.fetchImpl,
|
|
64
|
-
// 500+ strategies with nested APY blocks — this is a large, slow payload.
|
|
65
|
-
timeoutMs: opts.timeoutMs ?? 45_000,
|
|
66
|
-
});
|
|
67
|
-
return Array.isArray(data) ? data : [];
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
export async function kaminoHealth(opts = {}) {
|
|
71
|
-
try {
|
|
72
|
-
const raw = await fetchMetrics({}, opts);
|
|
73
|
-
const funded = raw.filter((s) => (Number(s.totalValueLocked) || 0) > 0).length;
|
|
74
|
-
return {
|
|
75
|
-
ok: raw.length > 0,
|
|
76
|
-
provider: "kamino-strategies",
|
|
77
|
-
strategies: raw.length,
|
|
78
|
-
funded,
|
|
79
|
-
exec: false,
|
|
80
|
-
};
|
|
81
|
-
} catch (error) {
|
|
82
|
-
return { ok: false, provider: "kamino-strategies", error: String(error?.message || error), exec: false };
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
/**
|
|
87
|
-
* Live strategies, filterable and ranked. Defaults hide the long tail of
|
|
88
|
-
* empty/dust vaults, which are the bulk of the 500+ raw rows and are not
|
|
89
|
-
* actionable yield.
|
|
90
|
-
*/
|
|
91
|
-
export async function kaminoStrategies(args = {}, opts = {}) {
|
|
92
|
-
const raw = await fetchMetrics(args, opts);
|
|
93
|
-
let strategies = raw.map(normalizeStrategy);
|
|
94
|
-
const total = strategies.length;
|
|
95
|
-
|
|
96
|
-
const minTvl = Number.isFinite(Number(args.minTvlUsd)) ? Number(args.minTvlUsd) : 10_000;
|
|
97
|
-
strategies = strategies.filter((s) => s.tvlUsd >= minTvl);
|
|
98
|
-
|
|
99
|
-
if (args.token) {
|
|
100
|
-
const want = String(args.token).toLowerCase();
|
|
101
|
-
strategies = strategies.filter(
|
|
102
|
-
(s) =>
|
|
103
|
-
String(s.tokenA || "").toLowerCase() === want ||
|
|
104
|
-
String(s.tokenB || "").toLowerCase() === want ||
|
|
105
|
-
s.tokenAMint === args.token ||
|
|
106
|
-
s.tokenBMint === args.token
|
|
107
|
-
);
|
|
108
|
-
}
|
|
109
|
-
if (args.pair) {
|
|
110
|
-
const want = String(args.pair).toLowerCase().replace(/[/_]/g, "-");
|
|
111
|
-
strategies = strategies.filter((s) => String(s.pair || "").toLowerCase() === want);
|
|
112
|
-
}
|
|
113
|
-
if (args.inRangeOnly === true) strategies = strategies.filter((s) => !s.outOfRange);
|
|
114
|
-
|
|
115
|
-
const sortBy = String(args.sortBy || "apy");
|
|
116
|
-
strategies.sort((a, b) => (sortBy === "tvl" ? b.tvlUsd - a.tvlUsd : b.totalApy - a.totalApy));
|
|
117
|
-
|
|
118
|
-
const limit = Number.isFinite(Number(args.limit)) && Number(args.limit) > 0 ? Number(args.limit) : 25;
|
|
119
|
-
const page = strategies.slice(0, limit);
|
|
120
|
-
|
|
121
|
-
return {
|
|
122
|
-
provider: "kamino-strategies",
|
|
123
|
-
chain: "solana-mainnet-beta",
|
|
124
|
-
env: args.env || "mainnet-beta",
|
|
125
|
-
status: args.status || "LIVE",
|
|
126
|
-
totalStrategies: total,
|
|
127
|
-
matched: strategies.length,
|
|
128
|
-
count: page.length,
|
|
129
|
-
minTvlUsd: minTvl,
|
|
130
|
-
tvlUsdMatched: strategies.reduce((a, s) => a + s.tvlUsd, 0),
|
|
131
|
-
strategies: page,
|
|
132
|
-
};
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
/** Metrics for one strategy address. */
|
|
136
|
-
export async function kaminoStrategyMetrics(args = {}, opts = {}) {
|
|
137
|
-
const address = String(args.strategy || args.address || "").trim();
|
|
138
|
-
if (!address) throw new Error("kamino-strategies: strategy address required");
|
|
139
|
-
const raw = await fetchMetrics({ ...args, status: args.status || "ALL" }, opts);
|
|
140
|
-
const found = raw.find((s) => s.strategy === address);
|
|
141
|
-
if (!found) throw new Error(`kamino-strategies: strategy ${address} not found`);
|
|
142
|
-
return { provider: "kamino-strategies", chain: "solana-mainnet-beta", ...normalizeStrategy(found), raw: found };
|
|
143
|
-
}
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
// L2Beat — L2 scaling TVL and activity data (no API key).
|
|
2
|
-
|
|
3
|
-
import { httpJson } from "../http.mjs";
|
|
4
|
-
|
|
5
|
-
export const L2BEAT_API = "https://api.l2beat.com";
|
|
6
|
-
|
|
7
|
-
function base(opts = {}) {
|
|
8
|
-
return (opts.baseUrl || process.env.L2BEAT_API_URL || L2BEAT_API).replace(/\/$/, "");
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
export async function l2beatHealth(opts = {}) {
|
|
12
|
-
try {
|
|
13
|
-
const data = await httpJson(`${base(opts)}/api/scaling/tvl`, {
|
|
14
|
-
fetchImpl: opts.fetchImpl,
|
|
15
|
-
timeoutMs: opts.timeoutMs ?? 15_000,
|
|
16
|
-
});
|
|
17
|
-
return { ok: data && typeof data.totalUsd === "string", provider: "l2beat-tvl" };
|
|
18
|
-
} catch (e) {
|
|
19
|
-
return { ok: false, provider: "l2beat-tvl", error: String(e.message || e).slice(0, 120) };
|
|
20
|
-
}
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export async function l2beatTvl(args = {}, opts = {}) {
|
|
24
|
-
const data = await httpJson(`${base(opts)}/api/scaling/tvl`, {
|
|
25
|
-
fetchImpl: opts.fetchImpl,
|
|
26
|
-
timeoutMs: opts.timeoutMs ?? 20_000,
|
|
27
|
-
});
|
|
28
|
-
if (args.project) {
|
|
29
|
-
const name = String(args.project).toLowerCase();
|
|
30
|
-
const projects = data?.projects || {};
|
|
31
|
-
const found = Object.entries(projects).find(([k]) => String(k).toLowerCase() === name);
|
|
32
|
-
return found ? { [found[0]]: found[1] } : {};
|
|
33
|
-
}
|
|
34
|
-
return data;
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
export async function l2beatActivity(args = {}, opts = {}) {
|
|
38
|
-
return httpJson(`${base(opts)}/api/scaling/activity`, {
|
|
39
|
-
fetchImpl: opts.fetchImpl,
|
|
40
|
-
timeoutMs: opts.timeoutMs ?? 20_000,
|
|
41
|
-
});
|
|
42
|
-
}
|