@oobe-protocol-labs/sap-mcp-server 0.9.38 → 0.9.51

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.
Files changed (178) hide show
  1. package/dist/config/env.d.ts +19 -0
  2. package/dist/config/env.d.ts.map +1 -1
  3. package/dist/config/env.js +9 -2
  4. package/dist/config/env.js.map +1 -1
  5. package/dist/config/mcp-client-injection.d.ts +1 -1
  6. package/dist/config/mcp-client-injection.d.ts.map +1 -1
  7. package/dist/config/mcp-client-injection.js +35 -0
  8. package/dist/config/mcp-client-injection.js.map +1 -1
  9. package/dist/config/wizard.js +2 -2
  10. package/dist/config/wizard.js.map +1 -1
  11. package/dist/core/constants.d.ts +1 -1
  12. package/dist/core/constants.js +1 -1
  13. package/dist/core/logger.js +1 -1
  14. package/dist/payments/monetization-gate.d.ts +5 -0
  15. package/dist/payments/monetization-gate.d.ts.map +1 -1
  16. package/dist/payments/monetization-gate.js +39 -2
  17. package/dist/payments/monetization-gate.js.map +1 -1
  18. package/dist/payments/prepaid-credit-store.d.ts +111 -0
  19. package/dist/payments/prepaid-credit-store.d.ts.map +1 -0
  20. package/dist/payments/prepaid-credit-store.js +230 -0
  21. package/dist/payments/prepaid-credit-store.js.map +1 -0
  22. package/dist/payments/pricing.d.ts.map +1 -1
  23. package/dist/payments/pricing.js +1 -0
  24. package/dist/payments/pricing.js.map +1 -1
  25. package/dist/payments/schema-validation.d.ts +52 -0
  26. package/dist/payments/schema-validation.d.ts.map +1 -0
  27. package/dist/payments/schema-validation.js +112 -0
  28. package/dist/payments/schema-validation.js.map +1 -0
  29. package/dist/payments/x402-paid-call.d.ts +21 -0
  30. package/dist/payments/x402-paid-call.d.ts.map +1 -1
  31. package/dist/payments/x402-paid-call.js +108 -3
  32. package/dist/payments/x402-paid-call.js.map +1 -1
  33. package/dist/perps/adrena/adrena-builder-commodity.d.ts +63 -0
  34. package/dist/perps/adrena/adrena-builder-commodity.d.ts.map +1 -0
  35. package/dist/perps/adrena/adrena-builder-commodity.js +200 -0
  36. package/dist/perps/adrena/adrena-builder-commodity.js.map +1 -0
  37. package/dist/perps/adrena/adrena-builder-core.d.ts +319 -0
  38. package/dist/perps/adrena/adrena-builder-core.d.ts.map +1 -0
  39. package/dist/perps/adrena/adrena-builder-core.js +516 -0
  40. package/dist/perps/adrena/adrena-builder-core.js.map +1 -0
  41. package/dist/perps/adrena/adrena-builder-liquidity.d.ts +50 -0
  42. package/dist/perps/adrena/adrena-builder-liquidity.d.ts.map +1 -0
  43. package/dist/perps/adrena/adrena-builder-liquidity.js +196 -0
  44. package/dist/perps/adrena/adrena-builder-liquidity.js.map +1 -0
  45. package/dist/perps/adrena/adrena-builder-staking.d.ts +57 -0
  46. package/dist/perps/adrena/adrena-builder-staking.d.ts.map +1 -0
  47. package/dist/perps/adrena/adrena-builder-staking.js +368 -0
  48. package/dist/perps/adrena/adrena-builder-staking.js.map +1 -0
  49. package/dist/perps/adrena/adrena-builder-trading.d.ts +160 -0
  50. package/dist/perps/adrena/adrena-builder-trading.d.ts.map +1 -0
  51. package/dist/perps/adrena/adrena-builder-trading.js +835 -0
  52. package/dist/perps/adrena/adrena-builder-trading.js.map +1 -0
  53. package/dist/perps/adrena/adrena-builder.d.ts +14 -293
  54. package/dist/perps/adrena/adrena-builder.d.ts.map +1 -1
  55. package/dist/perps/adrena/adrena-builder.js +14 -1140
  56. package/dist/perps/adrena/adrena-builder.js.map +1 -1
  57. package/dist/perps/adrena/adrena-constants.d.ts +33 -5
  58. package/dist/perps/adrena/adrena-constants.d.ts.map +1 -1
  59. package/dist/perps/adrena/adrena-constants.js +29 -7
  60. package/dist/perps/adrena/adrena-constants.js.map +1 -1
  61. package/dist/perps/adrena/adrena-idl.d.ts +15084 -0
  62. package/dist/perps/adrena/adrena-idl.d.ts.map +1 -0
  63. package/dist/perps/adrena/adrena-idl.js +29902 -0
  64. package/dist/perps/adrena/adrena-idl.js.map +1 -0
  65. package/dist/perps/adrena/adrena-pda.d.ts +5 -4
  66. package/dist/perps/adrena/adrena-pda.d.ts.map +1 -1
  67. package/dist/perps/adrena/adrena-pda.js +6 -10
  68. package/dist/perps/adrena/adrena-pda.js.map +1 -1
  69. package/dist/perps/adrena/index.d.ts +1 -0
  70. package/dist/perps/adrena/index.d.ts.map +1 -1
  71. package/dist/perps/adrena/index.js +1 -0
  72. package/dist/perps/adrena/index.js.map +1 -1
  73. package/dist/perps/chart-indicators.d.ts +27 -0
  74. package/dist/perps/chart-indicators.d.ts.map +1 -0
  75. package/dist/perps/chart-indicators.js +345 -0
  76. package/dist/perps/chart-indicators.js.map +1 -0
  77. package/dist/perps/chart-tools.d.ts +45 -0
  78. package/dist/perps/chart-tools.d.ts.map +1 -0
  79. package/dist/perps/chart-tools.js +341 -0
  80. package/dist/perps/chart-tools.js.map +1 -0
  81. package/dist/perps/perp-analytics-tools.d.ts +20 -0
  82. package/dist/perps/perp-analytics-tools.d.ts.map +1 -0
  83. package/dist/perps/perp-analytics-tools.js +868 -0
  84. package/dist/perps/perp-analytics-tools.js.map +1 -0
  85. package/dist/perps/perp-constants.d.ts +362 -0
  86. package/dist/perps/perp-constants.d.ts.map +1 -0
  87. package/dist/perps/perp-constants.js +210 -0
  88. package/dist/perps/perp-constants.js.map +1 -0
  89. package/dist/perps/perp-decoders.d.ts +47 -0
  90. package/dist/perps/perp-decoders.d.ts.map +1 -0
  91. package/dist/perps/perp-decoders.js +332 -0
  92. package/dist/perps/perp-decoders.js.map +1 -0
  93. package/dist/policy/policy-engine.d.ts +42 -0
  94. package/dist/policy/policy-engine.d.ts.map +1 -1
  95. package/dist/policy/policy-engine.js +43 -0
  96. package/dist/policy/policy-engine.js.map +1 -1
  97. package/dist/premium/activation-manager.d.ts.map +1 -1
  98. package/dist/premium/activation-manager.js +20 -2
  99. package/dist/premium/activation-manager.js.map +1 -1
  100. package/dist/prompts/context/sap-agent-context.prompt.js +15 -1
  101. package/dist/prompts/context/sap-agent-context.prompt.js.map +1 -1
  102. package/dist/server/server-metadata.d.ts +13 -0
  103. package/dist/server/server-metadata.d.ts.map +1 -1
  104. package/dist/server/server-metadata.js +15 -2
  105. package/dist/server/server-metadata.js.map +1 -1
  106. package/dist/solana/ata-utils.d.ts +39 -0
  107. package/dist/solana/ata-utils.d.ts.map +1 -0
  108. package/dist/solana/ata-utils.js +49 -0
  109. package/dist/solana/ata-utils.js.map +1 -0
  110. package/dist/strategies/trade-journal.d.ts +78 -0
  111. package/dist/strategies/trade-journal.d.ts.map +1 -0
  112. package/dist/strategies/trade-journal.js +92 -0
  113. package/dist/strategies/trade-journal.js.map +1 -0
  114. package/dist/tools/adrena/adrena-commodity-tools.d.ts +15 -0
  115. package/dist/tools/adrena/adrena-commodity-tools.d.ts.map +1 -0
  116. package/dist/tools/adrena/adrena-commodity-tools.js +137 -0
  117. package/dist/tools/adrena/adrena-commodity-tools.js.map +1 -0
  118. package/dist/tools/adrena/adrena-data-tools.d.ts +23 -0
  119. package/dist/tools/adrena/adrena-data-tools.d.ts.map +1 -0
  120. package/dist/tools/adrena/adrena-data-tools.js +437 -0
  121. package/dist/tools/adrena/adrena-data-tools.js.map +1 -0
  122. package/dist/tools/adrena/adrena-helpers.d.ts +46 -0
  123. package/dist/tools/adrena/adrena-helpers.d.ts.map +1 -0
  124. package/dist/tools/adrena/adrena-helpers.js +41 -0
  125. package/dist/tools/adrena/adrena-helpers.js.map +1 -0
  126. package/dist/tools/adrena/adrena-index.d.ts +20 -0
  127. package/dist/tools/adrena/adrena-index.d.ts.map +1 -0
  128. package/dist/tools/adrena/adrena-index.js +75 -0
  129. package/dist/tools/adrena/adrena-index.js.map +1 -0
  130. package/dist/tools/adrena/adrena-limit-order-tools.d.ts +22 -0
  131. package/dist/tools/adrena/adrena-limit-order-tools.d.ts.map +1 -0
  132. package/dist/tools/adrena/adrena-limit-order-tools.js +91 -0
  133. package/dist/tools/adrena/adrena-limit-order-tools.js.map +1 -0
  134. package/dist/tools/adrena/adrena-liquidity-tools.d.ts +15 -0
  135. package/dist/tools/adrena/adrena-liquidity-tools.d.ts.map +1 -0
  136. package/dist/tools/adrena/adrena-liquidity-tools.js +108 -0
  137. package/dist/tools/adrena/adrena-liquidity-tools.js.map +1 -0
  138. package/dist/tools/adrena/adrena-snapshot-tools.d.ts +42 -0
  139. package/dist/tools/adrena/adrena-snapshot-tools.d.ts.map +1 -0
  140. package/dist/tools/adrena/adrena-snapshot-tools.js +124 -0
  141. package/dist/tools/adrena/adrena-snapshot-tools.js.map +1 -0
  142. package/dist/tools/adrena/adrena-staking-tools.d.ts +15 -0
  143. package/dist/tools/adrena/adrena-staking-tools.d.ts.map +1 -0
  144. package/dist/tools/adrena/adrena-staking-tools.js +139 -0
  145. package/dist/tools/adrena/adrena-staking-tools.js.map +1 -0
  146. package/dist/tools/adrena/adrena-trading-tools.d.ts +78 -0
  147. package/dist/tools/adrena/adrena-trading-tools.d.ts.map +1 -0
  148. package/dist/tools/adrena/adrena-trading-tools.js +556 -0
  149. package/dist/tools/adrena/adrena-trading-tools.js.map +1 -0
  150. package/dist/tools/adrena-tools.d.ts +1 -66
  151. package/dist/tools/adrena-tools.d.ts.map +1 -1
  152. package/dist/tools/adrena-tools.js +1 -1061
  153. package/dist/tools/adrena-tools.js.map +1 -1
  154. package/dist/tools/client-sdk-tools.js +1 -1
  155. package/dist/tools/client-sdk-tools.js.map +1 -1
  156. package/dist/tools/memory-tools.d.ts.map +1 -1
  157. package/dist/tools/memory-tools.js +170 -0
  158. package/dist/tools/memory-tools.js.map +1 -1
  159. package/dist/tools/perp-tools.d.ts +6 -174
  160. package/dist/tools/perp-tools.d.ts.map +1 -1
  161. package/dist/tools/perp-tools.js +6 -1716
  162. package/dist/tools/perp-tools.js.map +1 -1
  163. package/dist/tools/premium-tools.d.ts.map +1 -1
  164. package/dist/tools/premium-tools.js +123 -5
  165. package/dist/tools/premium-tools.js.map +1 -1
  166. package/dist/tools/skills-tools.d.ts.map +1 -1
  167. package/dist/tools/skills-tools.js +7 -4
  168. package/dist/tools/skills-tools.js.map +1 -1
  169. package/dist/tools/transaction-tools.d.ts +21 -1
  170. package/dist/tools/transaction-tools.d.ts.map +1 -1
  171. package/dist/tools/transaction-tools.js +114 -30
  172. package/dist/tools/transaction-tools.js.map +1 -1
  173. package/dist/tools/x402-paid-call-tool.d.ts.map +1 -1
  174. package/dist/tools/x402-paid-call-tool.js +288 -0
  175. package/dist/tools/x402-paid-call-tool.js.map +1 -1
  176. package/package.json +3 -2
  177. package/server.json +3 -3
  178. package/skills/sap-clawpump-bridge/SKILL.md +206 -0
@@ -0,0 +1,47 @@
1
+ /**
2
+ * @name perps/perp-decoders
3
+ * @description Adrena account decoders for Pool, Custody, and Position accounts.
4
+ *
5
+ * All decoders use the official Adrena release/39 ABI layout and read directly
6
+ * from raw account data buffers returned by Solana RPC `getProgramAccounts`.
7
+ *
8
+ * @module perps/perp-decoders
9
+ */
10
+ import { PublicKey } from '@solana/web3.js';
11
+ import type { SapMcpContext } from '../core/types.js';
12
+ import { type DecodedAdrenaCustody, type DecodedAdrenaPool, type DecodedAdrenaPosition, type PerpMarketProviderRecord } from './perp-constants.js';
13
+ export declare function readPublicKey(buf: Buffer, offset: number): string;
14
+ /**
15
+ * @name discToBase58
16
+ * @description Convert an 8-byte discriminator Buffer to a base58 string for
17
+ * use in `getProgramAccounts` memcmp filters.
18
+ *
19
+ * @param disc — 8-byte discriminator Buffer.
20
+ * @returns Base58-encoded string.
21
+ *
22
+ * @internal
23
+ */
24
+ export declare function discToBase58(disc: Buffer): string;
25
+ /**
26
+ * @name readAdrenaLimitedString
27
+ * @description Read Adrena `LimitedString` (31-byte value + 1-byte length)
28
+ * from an account data buffer.
29
+ *
30
+ * @param buf — Source buffer.
31
+ * @param offset — Offset to the LimitedString field.
32
+ * @returns Decoded symbol string, or empty string on failure.
33
+ *
34
+ * @internal
35
+ */
36
+ export declare function readAdrenaLimitedString(buf: Buffer, offset: number): string;
37
+ export declare function decodeAdrenaPoolAccount(pubkey: PublicKey, data: Buffer): DecodedAdrenaPool | null;
38
+ export declare function decodeAdrenaCustodyAccount(pubkey: PublicKey, data: Buffer, pool?: DecodedAdrenaPool): DecodedAdrenaCustody | null;
39
+ export declare function decodeAdrenaPositionAccount(pubkey: PublicKey, data: Buffer, marketsByCustody?: Map<string, DecodedAdrenaCustody>): DecodedAdrenaPosition | null;
40
+ export declare function readAdrenaMarketsByCustody(context: SapMcpContext): Promise<Map<string, DecodedAdrenaCustody>>;
41
+ export declare function getAdrenaProgramId(context: SapMcpContext): PublicKey;
42
+ export declare function fetchConfiguredPerpMarkets(context: SapMcpContext, marketFilter: string): Promise<{
43
+ markets: PerpMarketProviderRecord[];
44
+ source: string;
45
+ timestamp?: number;
46
+ } | null>;
47
+ //# sourceMappingURL=perp-decoders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"perp-decoders.d.ts","sourceRoot":"","sources":["../../src/perps/perp-decoders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAaL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAE9B,MAAM,qBAAqB,CAAC;AAwC7B,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAYD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA4BjG;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,IAAI,CA4EjI;AAQD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAa,GAC9D,qBAAqB,GAAG,IAAI,CA0D9B;AAMD,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAkCnH;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAEpE;AAMD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IACT,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,CAsBR"}
@@ -0,0 +1,332 @@
1
+ /**
2
+ * @name perps/perp-decoders
3
+ * @description Adrena account decoders for Pool, Custody, and Position accounts.
4
+ *
5
+ * All decoders use the official Adrena release/39 ABI layout and read directly
6
+ * from raw account data buffers returned by Solana RPC `getProgramAccounts`.
7
+ *
8
+ * @module perps/perp-decoders
9
+ */
10
+ import { PublicKey } from '@solana/web3.js';
11
+ import bs58 from 'bs58';
12
+ import { ADRENA_BPS_DECIMALS, ADRENA_CUSTODY_OFFSETS, ADRENA_MAINNET_MARKETS_BY_CUSTODY, ADRENA_MAINNET_POOLS, ADRENA_POOL_OFFSETS, ADRENA_POSITION_OFFSETS, ADRENA_PRICE_DECIMALS, ADRENA_USD_DECIMALS, DISC_CUSTODY, DISC_POOL, DISC_POSITION, getPerpsConfig, } from './perp-constants.js';
13
+ /* ═══════════════════════════════════════════════════════════════════
14
+ * Low-level buffer readers
15
+ * ═══════════════════════════════════════════════════════════════════ */
16
+ /**
17
+ * @name readU64LE
18
+ * @description Read a u64 little-endian value from a Buffer and return as a JS number.
19
+ *
20
+ * @param buf — Source buffer.
21
+ * @param offset — Read offset.
22
+ * @returns The value as a JavaScript number.
23
+ *
24
+ * @internal
25
+ */
26
+ function readU64LE(buf, offset) {
27
+ return Number(buf.readBigUInt64LE(offset));
28
+ }
29
+ /**
30
+ * @name readI64LE
31
+ * @description Read an i64 little-endian value from a Buffer and return as a JS number.
32
+ *
33
+ * @param buf — Source buffer.
34
+ * @param offset — Read offset.
35
+ * @returns The signed value as a JavaScript number.
36
+ *
37
+ * @internal
38
+ */
39
+ function readI64LE(buf, offset) {
40
+ return Number(buf.readBigInt64LE(offset));
41
+ }
42
+ function readU128Split(buf, offset) {
43
+ const high = buf.readBigUInt64LE(offset);
44
+ const low = buf.readBigUInt64LE(offset + 8);
45
+ return (high << 64n) + low;
46
+ }
47
+ export function readPublicKey(buf, offset) {
48
+ return new PublicKey(buf.subarray(offset, offset + 32)).toBase58();
49
+ }
50
+ function scaleNumber(raw, decimals) {
51
+ return Number(raw) / (10 ** decimals);
52
+ }
53
+ function readUsd(buf, offset) {
54
+ return scaleNumber(buf.readBigUInt64LE(offset), ADRENA_USD_DECIMALS);
55
+ }
56
+ function readPrice(buf, offset) {
57
+ return scaleNumber(buf.readBigUInt64LE(offset), ADRENA_PRICE_DECIMALS);
58
+ }
59
+ /* ═══════════════════════════════════════════════════════════════════
60
+ * Public decoder exports
61
+ * ═══════════════════════════════════════════════════════════════════ */
62
+ /**
63
+ * @name discToBase58
64
+ * @description Convert an 8-byte discriminator Buffer to a base58 string for
65
+ * use in `getProgramAccounts` memcmp filters.
66
+ *
67
+ * @param disc — 8-byte discriminator Buffer.
68
+ * @returns Base58-encoded string.
69
+ *
70
+ * @internal
71
+ */
72
+ export function discToBase58(disc) {
73
+ return bs58.encode(disc);
74
+ }
75
+ /**
76
+ * @name readAdrenaLimitedString
77
+ * @description Read Adrena `LimitedString` (31-byte value + 1-byte length)
78
+ * from an account data buffer.
79
+ *
80
+ * @param buf — Source buffer.
81
+ * @param offset — Offset to the LimitedString field.
82
+ * @returns Decoded symbol string, or empty string on failure.
83
+ *
84
+ * @internal
85
+ */
86
+ export function readAdrenaLimitedString(buf, offset) {
87
+ try {
88
+ const len = buf[offset + 31] ?? 0;
89
+ if (len === 0 || len > 31)
90
+ return '';
91
+ return buf.subarray(offset, offset + len).toString('utf8').replace(/\0/g, '').trim();
92
+ }
93
+ catch {
94
+ return '';
95
+ }
96
+ }
97
+ function inferAdrenaSymbolFromOracle(oracle, fallback) {
98
+ const normalized = oracle.toUpperCase().replace(/[^A-Z0-9]/g, '');
99
+ for (const candidate of ['JITOSOL', 'WBTC', 'BONK', 'USDC', 'XAU', 'WTI', 'XAG', 'SOL', 'BTC']) {
100
+ if (normalized.includes(candidate)) {
101
+ return candidate;
102
+ }
103
+ }
104
+ return fallback;
105
+ }
106
+ export function decodeAdrenaPoolAccount(pubkey, data) {
107
+ if (data.length < ADRENA_POOL_OFFSETS.custodies + 32) {
108
+ return null;
109
+ }
110
+ if (!data.subarray(0, 8).equals(DISC_POOL)) {
111
+ return null;
112
+ }
113
+ const poolAddress = pubkey.toBase58();
114
+ const registeredCustodyCount = data[ADRENA_POOL_OFFSETS.registeredCustodyCount] ?? 0;
115
+ const custodies = [];
116
+ const custodyCount = Math.min(registeredCustodyCount, 8);
117
+ for (let i = 0; i < custodyCount; i++) {
118
+ custodies.push(readPublicKey(data, ADRENA_POOL_OFFSETS.custodies + i * 32));
119
+ }
120
+ const manifestPool = ADRENA_MAINNET_POOLS[poolAddress];
121
+ return {
122
+ poolAddress,
123
+ name: readAdrenaLimitedString(data, ADRENA_POOL_OFFSETS.name) || manifestPool?.name || 'unknown-pool',
124
+ type: manifestPool?.type,
125
+ allowTrade: data[ADRENA_POOL_OFFSETS.allowTrade] !== 0,
126
+ allowSwap: data[ADRENA_POOL_OFFSETS.allowSwap] !== 0,
127
+ registeredCustodyCount,
128
+ custodies,
129
+ lpTokenPriceUsd: readUsd(data, ADRENA_POOL_OFFSETS.lpTokenPriceUsd),
130
+ aumUsd: scaleNumber(readU128Split(data, ADRENA_POOL_OFFSETS.aumUsd), ADRENA_USD_DECIMALS),
131
+ };
132
+ }
133
+ export function decodeAdrenaCustodyAccount(pubkey, data, pool) {
134
+ if (data.length < ADRENA_CUSTODY_OFFSETS.version + 1) {
135
+ return null;
136
+ }
137
+ if (!data.subarray(0, 8).equals(DISC_CUSTODY)) {
138
+ return null;
139
+ }
140
+ const custodyAddress = pubkey.toBase58();
141
+ const manifest = ADRENA_MAINNET_MARKETS_BY_CUSTODY[custodyAddress];
142
+ const poolAddress = readPublicKey(data, ADRENA_CUSTODY_OFFSETS.pool);
143
+ const custodyMint = readPublicKey(data, ADRENA_CUSTODY_OFFSETS.mint);
144
+ const oracle = readAdrenaLimitedString(data, ADRENA_CUSTODY_OFFSETS.oracle);
145
+ const tradeOracle = readAdrenaLimitedString(data, ADRENA_CUSTODY_OFFSETS.tradeOracle);
146
+ const inferredSymbol = inferAdrenaSymbolFromOracle(tradeOracle || oracle, custodyMint.slice(0, 6).toUpperCase());
147
+ const symbol = manifest?.symbol ?? inferredSymbol;
148
+ const isSynthetic = data[ADRENA_CUSTODY_OFFSETS.isSynthetic] !== 0;
149
+ const kind = manifest?.kind ?? (isSynthetic ? 'synthetic-perp' : 'unknown');
150
+ return {
151
+ symbol,
152
+ market: manifest?.market ?? (kind === 'collateral' ? symbol : `${symbol}-PERP`),
153
+ custodyAddress,
154
+ poolAddress,
155
+ poolName: pool?.name ?? manifest?.poolName ?? ADRENA_MAINNET_POOLS[poolAddress]?.name,
156
+ poolType: pool?.type ?? ADRENA_MAINNET_POOLS[poolAddress]?.type,
157
+ custodyMint,
158
+ tokenAccount: readPublicKey(data, ADRENA_CUSTODY_OFFSETS.tokenAccount),
159
+ oracle,
160
+ tradeOracle,
161
+ oracleFeedId: data[ADRENA_CUSTODY_OFFSETS.oracleFeedId] ?? 0,
162
+ tradeOracleFeedId: data[ADRENA_CUSTODY_OFFSETS.tradeOracleFeedId] ?? 0,
163
+ decimals: data[ADRENA_CUSTODY_OFFSETS.decimals] ?? 0,
164
+ allowTrade: data[ADRENA_CUSTODY_OFFSETS.allowTrade] !== 0,
165
+ allowSwap: data[ADRENA_CUSTODY_OFFSETS.allowSwap] !== 0,
166
+ isStable: data[13] !== 0,
167
+ isSynthetic,
168
+ version: data[ADRENA_CUSTODY_OFFSETS.version] ?? 0,
169
+ kind,
170
+ markPrice: null,
171
+ markPriceSource: 'not_in_custody_account',
172
+ maxInitialLeverage: data.readUInt32LE(ADRENA_CUSTODY_OFFSETS.maxInitialLeverage) / (10 ** ADRENA_BPS_DECIMALS),
173
+ maxLeverage: data.readUInt32LE(ADRENA_CUSTODY_OFFSETS.maxLeverage) / (10 ** ADRENA_BPS_DECIMALS),
174
+ maxPositionLockedUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.maxPositionLockedUsd),
175
+ openInterestLong: readUsd(data, ADRENA_CUSTODY_OFFSETS.longPositionsSizeUsd),
176
+ openInterestShort: readUsd(data, ADRENA_CUSTODY_OFFSETS.shortPositionsSizeUsd),
177
+ openPositionsLong: readU64LE(data, ADRENA_CUSTODY_OFFSETS.longPositionsOpenCount),
178
+ openPositionsShort: readU64LE(data, ADRENA_CUSTODY_OFFSETS.shortPositionsOpenCount),
179
+ borrowSizeLongUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.longPositionsBorrowSizeUsd),
180
+ borrowSizeShortUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.shortPositionsBorrowSizeUsd),
181
+ collateralLongUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.longPositionsCollateralUsd),
182
+ collateralShortUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.shortPositionsCollateralUsd),
183
+ lockedAmountLongRaw: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.longPositionsLockedAmount).toString(),
184
+ lockedAmountShortRaw: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.shortPositionsLockedAmount).toString(),
185
+ tradeOiLongUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.tradeOiLongUsd),
186
+ tradeOiShortUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.tradeOiShortUsd),
187
+ cumulativeOpenPositionUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.volumeOpenPositionUsd),
188
+ assetsRaw: {
189
+ collateral: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.assetsCollateral).toString(),
190
+ owned: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.assetsOwned).toString(),
191
+ locked: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.assetsLocked).toString(),
192
+ },
193
+ borrowRate: {
194
+ currentRateRaw: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.borrowRateCurrent).toString(),
195
+ lastUpdate: readI64LE(data, ADRENA_CUSTODY_OFFSETS.borrowRateLastUpdate),
196
+ },
197
+ funding: {
198
+ currentRateLongToShortRaw: data.readBigInt64LE(ADRENA_CUSTODY_OFFSETS.virtualFundingCurrentLongToShort).toString(),
199
+ lastUpdate: readI64LE(data, ADRENA_CUSTODY_OFFSETS.virtualFundingLastUpdate),
200
+ cumulativeLongToShortRaw: readU128Split(data, ADRENA_CUSTODY_OFFSETS.virtualFundingCumulativeLongToShort).toString(),
201
+ cumulativeShortToLongRaw: readU128Split(data, ADRENA_CUSTODY_OFFSETS.virtualFundingCumulativeShortToLong).toString(),
202
+ maxHourlyFundingRateRaw: data.readBigUInt64LE(ADRENA_CUSTODY_OFFSETS.virtualFundingMaxHourlyRate).toString(),
203
+ minTotalOiUsd: readUsd(data, ADRENA_CUSTODY_OFFSETS.virtualFundingMinTotalOiUsd),
204
+ imbalanceSensitivityBps: data.readUInt16LE(ADRENA_CUSTODY_OFFSETS.virtualFundingImbalanceSensitivityBps),
205
+ },
206
+ };
207
+ }
208
+ function sideFromAdrenaByte(sideByte) {
209
+ if (sideByte === 1)
210
+ return 'long';
211
+ if (sideByte === 2)
212
+ return 'short';
213
+ return null;
214
+ }
215
+ export function decodeAdrenaPositionAccount(pubkey, data, marketsByCustody = new Map()) {
216
+ if (data.length < ADRENA_POSITION_OFFSETS.unrealizedFundingReceivedUsd + 8) {
217
+ return null;
218
+ }
219
+ if (!data.subarray(0, 8).equals(DISC_POSITION)) {
220
+ return null;
221
+ }
222
+ const sideRaw = data[ADRENA_POSITION_OFFSETS.side] ?? 0;
223
+ const side = sideFromAdrenaByte(sideRaw);
224
+ if (!side) {
225
+ return null;
226
+ }
227
+ const custodyAddress = readPublicKey(data, ADRENA_POSITION_OFFSETS.custody);
228
+ const market = marketsByCustody.get(custodyAddress)?.market ?? 'unknown';
229
+ const entryPrice = readPrice(data, ADRENA_POSITION_OFFSETS.price);
230
+ const sizeUsd = readUsd(data, ADRENA_POSITION_OFFSETS.sizeUsd);
231
+ const collateralUsd = readUsd(data, ADRENA_POSITION_OFFSETS.collateralUsd);
232
+ const leverage = collateralUsd > 0 ? sizeUsd / collateralUsd : 0;
233
+ const liquidationPrice = leverage > 0
234
+ ? side === 'long'
235
+ ? entryPrice * (1 - 1 / leverage)
236
+ : entryPrice * (1 + 1 / leverage)
237
+ : 0;
238
+ const takeProfitLimitPrice = readPrice(data, ADRENA_POSITION_OFFSETS.takeProfitLimitPrice);
239
+ const stopLossLimitPrice = readPrice(data, ADRENA_POSITION_OFFSETS.stopLossLimitPrice);
240
+ const stopLossClosePositionPrice = readPrice(data, ADRENA_POSITION_OFFSETS.stopLossClosePositionPrice);
241
+ return {
242
+ positionKey: pubkey.toBase58(),
243
+ market,
244
+ side,
245
+ sideRaw,
246
+ owner: readPublicKey(data, ADRENA_POSITION_OFFSETS.owner),
247
+ poolAddress: readPublicKey(data, ADRENA_POSITION_OFFSETS.pool),
248
+ custodyAddress,
249
+ collateralCustodyAddress: readPublicKey(data, ADRENA_POSITION_OFFSETS.collateralCustody),
250
+ openTime: readI64LE(data, ADRENA_POSITION_OFFSETS.openTime),
251
+ updateTime: readI64LE(data, ADRENA_POSITION_OFFSETS.updateTime),
252
+ entryPrice,
253
+ entryPriceRaw: data.readBigUInt64LE(ADRENA_POSITION_OFFSETS.price).toString(),
254
+ size: sizeUsd,
255
+ collateral: collateralUsd,
256
+ borrowSizeUsd: readUsd(data, ADRENA_POSITION_OFFSETS.borrowSizeUsd),
257
+ leverage,
258
+ unrealizedPnl: 0,
259
+ unrealizedInterestUsd: readUsd(data, ADRENA_POSITION_OFFSETS.unrealizedInterestUsd),
260
+ unrealizedFundingPaidUsd: readUsd(data, ADRENA_POSITION_OFFSETS.unrealizedFundingPaidUsd),
261
+ unrealizedFundingReceivedUsd: readUsd(data, ADRENA_POSITION_OFFSETS.unrealizedFundingReceivedUsd),
262
+ lockedAmountRaw: data.readBigUInt64LE(ADRENA_POSITION_OFFSETS.lockedAmount).toString(),
263
+ collateralAmountRaw: data.readBigUInt64LE(ADRENA_POSITION_OFFSETS.collateralAmount).toString(),
264
+ liquidationPrice,
265
+ takeProfitLimitPrice: takeProfitLimitPrice > 0 ? takeProfitLimitPrice : null,
266
+ stopLossLimitPrice: stopLossLimitPrice > 0 ? stopLossLimitPrice : null,
267
+ stopLossClosePositionPrice: stopLossClosePositionPrice > 0 ? stopLossClosePositionPrice : null,
268
+ id: data.readBigUInt64LE(ADRENA_POSITION_OFFSETS.id).toString(),
269
+ };
270
+ }
271
+ /* ═══════════════════════════════════════════════════════════════════
272
+ * Shared RPC helpers
273
+ * ═══════════════════════════════════════════════════════════════════ */
274
+ export async function readAdrenaMarketsByCustody(context) {
275
+ const { PublicKey } = await import('@solana/web3.js');
276
+ const adrenaProgramId = new PublicKey(getPerpsConfig(context).adrenaProgramId || '13gDzEXCdocbj8iAiqrScGo47NiSuYENGsRqi3SEAwet');
277
+ const [poolAccounts, custodyAccounts] = await Promise.all([
278
+ context.connection.getProgramAccounts(adrenaProgramId, {
279
+ filters: [{ memcmp: { offset: 0, bytes: discToBase58(DISC_POOL) } }],
280
+ commitment: 'confirmed',
281
+ }),
282
+ context.connection.getProgramAccounts(adrenaProgramId, {
283
+ filters: [{ memcmp: { offset: 0, bytes: discToBase58(DISC_CUSTODY) } }],
284
+ commitment: 'confirmed',
285
+ }),
286
+ ]);
287
+ const pools = new Map();
288
+ for (const { pubkey, account } of poolAccounts) {
289
+ const decoded = decodeAdrenaPoolAccount(pubkey, account.data);
290
+ if (decoded) {
291
+ pools.set(decoded.poolAddress, decoded);
292
+ }
293
+ }
294
+ const markets = new Map();
295
+ for (const { pubkey, account } of custodyAccounts) {
296
+ const poolAddress = account.data.length >= ADRENA_CUSTODY_OFFSETS.pool + 32
297
+ ? readPublicKey(account.data, ADRENA_CUSTODY_OFFSETS.pool)
298
+ : '';
299
+ const decoded = decodeAdrenaCustodyAccount(pubkey, account.data, pools.get(poolAddress));
300
+ if (decoded) {
301
+ markets.set(decoded.custodyAddress, decoded);
302
+ }
303
+ }
304
+ return markets;
305
+ }
306
+ export function getAdrenaProgramId(context) {
307
+ return new PublicKey(getPerpsConfig(context).adrenaProgramId || '13gDzEXCdocbj8iAiqrScGo47NiSuYENGsRqi3SEAwet');
308
+ }
309
+ /* ═══════════════════════════════════════════════════════════════════
310
+ * Provider fetch helpers
311
+ * ═══════════════════════════════════════════════════════════════════ */
312
+ export async function fetchConfiguredPerpMarkets(context, marketFilter) {
313
+ const perps = getPerpsConfig(context);
314
+ if (!perps.marketsUrl) {
315
+ return null;
316
+ }
317
+ const { timedFetch, appendQuery, perpsProviderHeaders, normalizePerpProviderMarkets } = await import('./perp-constants.js');
318
+ const url = appendQuery(perps.marketsUrl, { market: marketFilter || undefined });
319
+ const payload = await timedFetch(url, {
320
+ headers: perpsProviderHeaders(),
321
+ timeoutMs: perps.timeoutMs,
322
+ });
323
+ if (!payload) {
324
+ return null;
325
+ }
326
+ return {
327
+ markets: normalizePerpProviderMarkets(payload, marketFilter),
328
+ source: Array.isArray(payload) ? 'configured-perps-provider' : payload.source ?? payload.venue ?? 'configured-perps-provider',
329
+ timestamp: Array.isArray(payload) ? Date.now() : payload.timestamp,
330
+ };
331
+ }
332
+ //# sourceMappingURL=perp-decoders.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"perp-decoders.js","sourceRoot":"","sources":["../../src/perps/perp-decoders.ts"],"names":[],"mappings":"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"}
@@ -72,6 +72,48 @@ export declare class PolicyEngine {
72
72
  * Add custom policy
73
73
  */
74
74
  addPolicy(policy: SapPolicy): void;
75
+ /**
76
+ * @name TradingPolicy
77
+ * @description Trading-specific policy limits enforced at the builder level.
78
+ * Prevents catastrophic loss from agent parameter errors.
79
+ */
80
+ getTradingPolicy(): TradingPolicy;
81
+ /**
82
+ * @name validateTradingPolicy
83
+ * @description Validate trading parameters against policy limits.
84
+ * Called by Adrena builders before constructing the transaction.
85
+ */
86
+ validateTradingPolicy(params: TradingPolicyParams): PolicyViolationResult;
87
+ }
88
+ /** Trading-specific policy limits. */
89
+ export interface TradingPolicy {
90
+ maxCollateralUsdPerTrade: number;
91
+ maxLeverage: number;
92
+ maxOpenPositions: number;
93
+ allowedMarkets: string[];
94
+ stopLossRequired: boolean;
95
+ maxSlippageBps: number;
96
+ requireHumanAckAboveUsd: number;
97
+ }
98
+ /** Parameters for trading policy validation. */
99
+ export interface TradingPolicyParams {
100
+ market: string;
101
+ side: string;
102
+ collateralUsd: number;
103
+ leverage: number;
104
+ hasStopLoss: boolean;
105
+ slippageBps?: number;
106
+ }
107
+ /** Result of trading policy validation. */
108
+ export interface PolicyViolationResult {
109
+ allowed: boolean;
110
+ violation?: string;
111
+ message?: string;
112
+ field?: string;
113
+ max?: number;
114
+ received?: number;
115
+ threshold?: number;
116
+ allowed_list?: string[];
75
117
  }
76
118
  export {};
77
119
  //# sourceMappingURL=policy-engine.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"policy-engine.d.ts","sourceRoot":"","sources":["../../src/policy/policy-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAO/E,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,kBAAkB,CAA4B;gBAE1C,MAAM,EAAE,YAAY;IAiBhC;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACxD,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,aAAa,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAmBF;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCjD;;OAEG;IACH,gBAAgB,IAAI;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,iBAAiB,EAAE,OAAO,CAAC;KAC5B;IAaD,OAAO,CAAC,wBAAwB;YAqClB,iBAAiB;IAwB/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIlD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAInC"}
1
+ {"version":3,"file":"policy-engine.d.ts","sourceRoot":"","sources":["../../src/policy/policy-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAO/E,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,kBAAkB,CAA4B;gBAE1C,MAAM,EAAE,YAAY;IAiBhC;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACxD,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,aAAa,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAmBF;;OAEG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCjD;;OAEG;IACH,gBAAgB,IAAI;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,iBAAiB,EAAE,OAAO,CAAC;KAC5B;IAaD,OAAO,CAAC,wBAAwB;YAqClB,iBAAiB;IAwB/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIlD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAKlC;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;IAYjC;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB;CA6B1E;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
@@ -178,5 +178,48 @@ export class PolicyEngine {
178
178
  this.policies.set(policy.id, policy);
179
179
  logger.info('Policy added', { policyId: policy.id });
180
180
  }
181
+ /**
182
+ * @name TradingPolicy
183
+ * @description Trading-specific policy limits enforced at the builder level.
184
+ * Prevents catastrophic loss from agent parameter errors.
185
+ */
186
+ getTradingPolicy() {
187
+ return {
188
+ maxCollateralUsdPerTrade: this.config.maxCollateralUsdPerTrade ?? 50,
189
+ maxLeverage: this.config.maxLeverage ?? 100,
190
+ maxOpenPositions: this.config.maxOpenPositions ?? 3,
191
+ allowedMarkets: this.config.allowedMarkets ?? ['BONK', 'JITOSOL', 'WBTC', 'USDC', 'XAU', 'XAG', 'WTI'],
192
+ stopLossRequired: this.config.stopLossRequired ?? true,
193
+ maxSlippageBps: this.config.maxSlippageBps ?? 500,
194
+ requireHumanAckAboveUsd: this.config.requireHumanAckAboveUsd ?? 30,
195
+ };
196
+ }
197
+ /**
198
+ * @name validateTradingPolicy
199
+ * @description Validate trading parameters against policy limits.
200
+ * Called by Adrena builders before constructing the transaction.
201
+ */
202
+ validateTradingPolicy(params) {
203
+ const policy = this.getTradingPolicy();
204
+ if (params.leverage > policy.maxLeverage) {
205
+ return { allowed: false, violation: 'leverage_exceeded', message: `Leverage ${params.leverage} exceeds max ${policy.maxLeverage}`, field: 'leverage', max: policy.maxLeverage, received: params.leverage };
206
+ }
207
+ if (params.collateralUsd > policy.maxCollateralUsdPerTrade) {
208
+ return { allowed: false, violation: 'collateral_exceeded', message: `Collateral $${params.collateralUsd} exceeds max $${policy.maxCollateralUsdPerTrade}`, field: 'collateralUsd', max: policy.maxCollateralUsdPerTrade, received: params.collateralUsd };
209
+ }
210
+ if (policy.allowedMarkets.length > 0 && !policy.allowedMarkets.includes(params.market)) {
211
+ return { allowed: false, violation: 'market_not_allowed', message: `Market ${params.market} not in allowed list: ${policy.allowedMarkets.join(', ')}`, field: 'market', allowed_list: policy.allowedMarkets };
212
+ }
213
+ if (policy.stopLossRequired && !params.hasStopLoss) {
214
+ return { allowed: false, violation: 'stop_loss_required', message: 'Stop loss is required by policy but none was provided', field: 'stopLoss' };
215
+ }
216
+ if (params.slippageBps !== undefined && params.slippageBps > policy.maxSlippageBps) {
217
+ return { allowed: false, violation: 'slippage_exceeded', message: `Slippage ${params.slippageBps} bps exceeds max ${policy.maxSlippageBps} bps`, field: 'slippageBps', max: policy.maxSlippageBps, received: params.slippageBps };
218
+ }
219
+ if (policy.requireHumanAckAboveUsd > 0 && params.collateralUsd > policy.requireHumanAckAboveUsd) {
220
+ return { allowed: false, violation: 'human_ack_required', message: `Collateral $${params.collateralUsd} exceeds human acknowledgment threshold $${policy.requireHumanAckAboveUsd}. User must confirm.`, field: 'collateralUsd', threshold: policy.requireHumanAckAboveUsd, received: params.collateralUsd };
221
+ }
222
+ return { allowed: true };
223
+ }
181
224
  }
182
225
  //# sourceMappingURL=policy-engine.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"policy-engine.js","sourceRoot":"","sources":["../../src/policy/policy-engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"policy-engine.js","sourceRoot":"","sources":["../../src/policy/policy-engine.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"activation-manager.d.ts","sourceRoot":"","sources":["../../src/premium/activation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAsBpF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAuEjG"}
1
+ {"version":3,"file":"activation-manager.d.ts","sourceRoot":"","sources":["../../src/premium/activation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA2CpF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CAuEjG"}
@@ -31,6 +31,10 @@ import { getPremiumSession } from './session-manager.js';
31
31
  * is the caller's responsibility. It only checks that the receipt is a non-empty
32
32
  * string of reasonable length.
33
33
  *
34
+ * Special case: the literal string "pending" is accepted but returns a special
35
+ * result telling the caller to provide the actual tx signature after settlement.
36
+ * This prevents agents from wasting a paid call when they don't have the receipt yet.
37
+ *
34
38
  * @param receipt - The opaque receipt string from x402/pay.sh settlement.
35
39
  * @returns True if the receipt has a valid structural format.
36
40
  *
@@ -39,12 +43,26 @@ import { getPremiumSession } from './session-manager.js';
39
43
  function verifyReceiptFormat(receipt) {
40
44
  if (typeof receipt !== 'string')
41
45
  return false;
42
- if (receipt.trim().length < 8)
46
+ if (receipt.trim().length < 8) {
43
47
  return false;
48
+ }
44
49
  if (receipt.length > 2048)
45
50
  return false;
46
51
  return true;
47
52
  }
53
+ /**
54
+ * @name RECEIPT_HELP_MESSAGE
55
+ * @description Help message shown when an agent passes "pending" or an invalid
56
+ * receipt. Explains exactly what the receipt should be and how to get it.
57
+ */
58
+ const RECEIPT_HELP_MESSAGE = 'The paymentReceipt must be the actual Solana transaction signature (tx hash) ' +
59
+ 'from the x402 facilitator settlement, not "pending" or a placeholder. ' +
60
+ 'Flow: 1) sap_premium_session_start creates a pending session (free). ' +
61
+ '2) The x402 challenge is settled via the local bridge (sap_payments_call_paid_tool ' +
62
+ 'or direct facilitator payment) — the facilitator returns a tx signature. ' +
63
+ '3) Pass that tx signature as paymentReceipt to this tool. ' +
64
+ 'Do NOT pass "pending" — it will always be rejected. ' +
65
+ 'If you do not have the tx signature yet, settle the payment first, then retry.';
48
66
  /**
49
67
  * @name activatePremiumSession
50
68
  * @description Activate a pending premium session with a payment receipt.
@@ -70,7 +88,7 @@ export function activatePremiumSession(request) {
70
88
  activatedAt: null,
71
89
  receiptBound: false,
72
90
  unitsQuota: 0,
73
- reason: 'Invalid payment receipt format. Ensure the x402/pay.sh receipt is a non-empty string.',
91
+ reason: RECEIPT_HELP_MESSAGE,
74
92
  };
75
93
  }
76
94
  const session = getPremiumSession(request.sessionId);
@@ -1 +1 @@
1
- {"version":3,"file":"activation-manager.js","sourceRoot":"","sources":["../../src/premium/activation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;;;;;;;;GAYG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAiC;IACtE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,iBAAiB;YACzB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,uFAAuF;SAChG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,mEAAmE;SAC5E,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,2BAA2B,EAAE,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,2BAA2B;YACnC,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,uEAAuE;SAChF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,mDAAmD;SAC5D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,OAAO,CAAC,SAAS;YAC9B,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,MAAM,EAAE,4BAA4B;SACrC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,uDAAuD;SAChE,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC"}
1
+ {"version":3,"file":"activation-manager.js","sourceRoot":"","sources":["../../src/premium/activation-manager.ts"],"names":[],"mappings":"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"}