npm - @ledgerhq/context-module - Versions diffs - 2.7.0 → 2.8.0 - Mend

@ledgerhq/context-module 2.7.0 → 2.8.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.

Files changed (100) hide show

package/lib/esm/src/modules/solana/instruction-info/data/HttpInstructionInfoDataSource.test.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/data/HttpInstructionInfoDataSource.test.ts"],
-  "sourcesContent": ["import { type DmkNetworkClient } from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { type ContextModuleServiceConfig } from \"@/config/model/ContextModuleConfig\";\nimport { SolanaTransactionScanChainId } from \"@/modules/solana/model/SolanaTransactionScanChainId\";\n\nimport { HttpInstructionInfoDataSource } from \"./HttpInstructionInfoDataSource\";\nimport { type InstructionInfoDataSource } from \"./InstructionInfoDataSource\";\nimport { type CalInstructionInfoResponseDto } from \"./InstructionInfoDto\";\n\ndescribe(\"HttpInstructionInfoDataSource\", () => {\n  let datasource: InstructionInfoDataSource;\n  let httpMock: { get: ReturnType<typeof vi.fn> };\n  const programId = \"11111111111111111111111111111111\";\n  const network = \"solana-mainnet\";\n  const config: ContextModuleServiceConfig = {\n    cal: {\n      url: \"https://global.api.prd.ledger.com/cal/v1\",\n      mode: \"prod\",\n      branch: \"main\",\n    },\n  } as ContextModuleServiceConfig;\n\n  const successResponse: CalInstructionInfoResponseDto = [\n    {\n      id: programId,\n      chain_id: SolanaTransactionScanChainId.MAINNET,\n      instructions: [\n        {\n          discriminator_hex: \"00000000\",\n          instruction_name: \"createAccount\",\n          descriptor: {\n            data: \"00010101\",\n            signatures: { prod: \"prodsig\", test: \"testsig\" },\n          },\n          display_fields: [],\n          value_flow_ports: [],\n          hide_rules: [],\n          account_resets: [],\n        },\n      ],\n    },\n  ];\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    httpMock = { get: vi.fn() };\n    datasource = new HttpInstructionInfoDataSource(\n      config,\n      httpMock as unknown as DmkNetworkClient,\n    );\n  });\n\n  it(\"calls CAL /solana_programs with id, chain_id and output params\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    await datasource.getInstructionInfo({ programId, network });\n\n    expect(httpMock.get).toHaveBeenCalledTimes(1);\n    expect(httpMock.get).toHaveBeenCalledWith(\n      \"https://global.api.prd.ledger.com/cal/v1/solana_programs\",\n      {\n        params: {\n          id: programId,\n          chain_id: SolanaTransactionScanChainId.MAINNET,\n          output: \"id,chain_id,instructions\",\n          ref: \"branch:main\",\n        },\n      },\n    );\n  });\n\n  it(\"maps devnet/testnet networks to their numeric chain ids\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    await datasource.getInstructionInfo({\n      programId,\n      network: \"solana-devnet\",\n    });\n\n    expect(httpMock.get).toHaveBeenCalledWith(\n      \"https://global.api.prd.ledger.com/cal/v1/solana_programs\",\n      expect.objectContaining({\n        params: expect.objectContaining({ chain_id: 901 }),\n      }),\n    );\n  });\n\n  it(\"returns Right with each descriptor transformed into the core payload on success\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Right({\n        programId,\n        descriptors: {\n          \"00000000\": Right({\n            programId,\n            discriminator: \"00000000\",\n            instructionName: \"createAccount\",\n            instructionInfo: { data: \"00010101\", signature: \"prodsig\" },\n            substructures: [],\n            enumVariants: [],\n            idlDescriptor: { typePool: [], rootType: 0 },\n            mintAssociations: [],\n            ownerAssociations: [],\n            valueFlowPorts: [],\n            accountResets: [],\n            displayFields: [],\n            hideRules: [],\n          }),\n        },\n        enumVariants: [],\n      }),\n    );\n  });\n\n  it(\"keys a descriptor without `discriminator_hex` under the empty string\", async () => {\n    // Single-instruction programs (e.g. SPL Memo `addMemo`) genuinely have no\n    // discriminator, so CAL omits the field.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            instruction_name: \"addMemo\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isRight()).toBe(true);\n    const { descriptors } = result.unsafeCoerce();\n    expect(Object.keys(descriptors)).toEqual([\"\"]);\n    expect(descriptors[\"\"]!.unsafeCoerce()).toEqual(\n      expect.objectContaining({\n        programId,\n        discriminator: \"\",\n        instructionInfo: { data: \"00010101\", signature: \"prodsig\" },\n      }),\n    );\n  });\n\n  it(\"returns Left when the response array is empty\", async () => {\n    httpMock.get.mockResolvedValue([]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new Error(\n          `[ContextModule] HttpInstructionInfoDataSource: empty response for program ${programId}`,\n        ),\n      ),\n    );\n  });\n\n  it(\"returns Left when no program object matches the requested programId\", async () => {\n    httpMock.get.mockResolvedValue([\n      {\n        id: \"OtherProgram\",\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new Error(\n          `[ContextModule] HttpInstructionInfoDataSource: no descriptors for program ${programId}`,\n        ),\n      ),\n    );\n  });\n\n  it(\"returns Left (not a throw) when an instruction descriptor is malformed\", async () => {\n    // `descriptor` missing on the instruction \u2014 would crash the loader if the\n    // datasource handed it through unvalidated.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [{ discriminator_hex: \"00000000\" }],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isLeft()).toBe(true);\n    expect((result.extract() as Error).message).toMatch(\n      new RegExp(\n        String.raw`\\[ContextModule\\] HttpInstructionInfoDataSource: malformed descriptors for program ${programId}:`,\n      ),\n    );\n  });\n\n  it(\"returns Left (not a throw) when account_schema.slots is not an array\", async () => {\n    // Regression: account_schema was not codec-validated, so a malformed\n    // shape (e.g. `slots` as an object instead of an array) bypassed\n    // validation here and crashed later in the mapper's `.map()` call instead\n    // of degrading gracefully to a per-program error.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            discriminator_hex: \"00000000\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n            account_schema: { slots: {} },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isLeft()).toBe(true);\n    expect((result.extract() as Error).message).toMatch(\n      new RegExp(\n        String.raw`\\[ContextModule\\] HttpInstructionInfoDataSource: malformed descriptors for program ${programId}:`,\n      ),\n    );\n  });\n\n  it(\"returns Right with accountSchema mapped through when it is well-formed\", async () => {\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            discriminator_hex: \"00000000\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n            account_schema: {\n              count_min: 2,\n              count_max: 2,\n              slots: [{ signer: \"REQUIRED\", writable: \"EITHER\" }],\n            },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isRight()).toBe(true);\n    const { descriptors } = result.unsafeCoerce();\n    expect(descriptors[\"00000000\"]!.unsafeCoerce()).toEqual(\n      expect.objectContaining({\n        accountSchema: {\n          count_min: 2,\n          count_max: 2,\n          remaining_policy: { signer: \"EITHER\", writable: \"EITHER\" },\n          slots: [{ signer: \"REQUIRED\", writable: \"EITHER\" }],\n        },\n      }),\n    );\n  });\n\n  it(\"returns Left when the HTTP client throws\", async () => {\n    httpMock.get.mockRejectedValue(new Error(\"network\"));\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new Error(\n          \"[ContextModule] HttpInstructionInfoDataSource: Failed to fetch instruction descriptors: network\",\n        ),\n      ),\n    );\n  });\n});\n"],
-  "mappings": "AACA,OAAS,QAAAA,EAAM,SAAAC,MAAa,YAC5B,OAAS,cAAAC,EAAY,YAAAC,EAAU,UAAAC,EAAQ,MAAAC,EAAI,MAAAC,MAAU,SAGrD,OAAS,gCAAAC,MAAoC,sDAE7C,OAAS,iCAAAC,MAAqC,kCAI9CL,EAAS,gCAAiC,IAAM,CAC9C,IAAIM,EACAC,EACJ,MAAMC,EAAY,mCACZC,EAAU,iBACVC,EAAqC,CACzC,IAAK,CACH,IAAK,2CACL,KAAM,OACN,OAAQ,MACV,CACF,EAEMC,EAAiD,CACrD,CACE,GAAIH,EACJ,SAAUJ,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,iBAAkB,gBAClB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CAAC,EACjB,iBAAkB,CAAC,EACnB,WAAY,CAAC,EACb,eAAgB,CAAC,CACnB,CACF,CACF,CACF,EAEAL,EAAW,IAAM,CACfI,EAAG,cAAc,EACjBI,EAAW,CAAE,IAAKJ,EAAG,GAAG,CAAE,EAC1BG,EAAa,IAAID,EACfK,EACAH,CACF,CACF,CAAC,EAEDL,EAAG,iEAAkE,SAAY,CAC/EK,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAE1DR,EAAOM,EAAS,GAAG,EAAE,sBAAsB,CAAC,EAC5CN,EAAOM,EAAS,GAAG,EAAE,qBACnB,2DACA,CACE,OAAQ,CACN,GAAIC,EACJ,SAAUJ,EAA6B,QACvC,OAAQ,2BACR,IAAK,aACP,CACF,CACF,CACF,CAAC,EAEDF,EAAG,0DAA2D,SAAY,CACxEK,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAClC,UAAAE,EACA,QAAS,eACX,CAAC,EAEDP,EAAOM,EAAS,GAAG,EAAE,qBACnB,2DACAN,EAAO,iBAAiB,CACtB,OAAQA,EAAO,iBAAiB,CAAE,SAAU,GAAI,CAAC,CACnD,CAAC,CACH,CACF,CAAC,EAEDC,EAAG,kFAAmF,SAAY,CAChGK,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAMC,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,CAAM,EAAE,QACbd,EAAM,CACJ,UAAAU,EACA,YAAa,CACX,WAAYV,EAAM,CAChB,UAAAU,EACA,cAAe,WACf,gBAAiB,gBACjB,gBAAiB,CAAE,KAAM,WAAY,UAAW,SAAU,EAC1D,cAAe,CAAC,EAChB,aAAc,CAAC,EACf,cAAe,CAAE,SAAU,CAAC,EAAG,SAAU,CAAE,EAC3C,iBAAkB,CAAC,EACnB,kBAAmB,CAAC,EACpB,eAAgB,CAAC,EACjB,cAAe,CAAC,EAChB,cAAe,CAAC,EAChB,UAAW,CAAC,CACd,CAAC,CACH,EACA,aAAc,CAAC,CACjB,CAAC,CACH,CACF,CAAC,EAEDN,EAAG,uEAAwE,SAAY,CAGrFK,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUJ,EAA6B,QACvC,aAAc,CACZ,CACE,iBAAkB,UAClB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,CACF,CACF,CACF,CACF,CAAC,EAED,MAAMQ,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClC,KAAM,CAAE,YAAAC,CAAY,EAAID,EAAO,aAAa,EAC5CX,EAAO,OAAO,KAAKY,CAAW,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAC7CZ,EAAOY,EAAY,EAAE,EAAG,aAAa,CAAC,EAAE,QACtCZ,EAAO,iBAAiB,CACtB,UAAAO,EACA,cAAe,GACf,gBAAiB,CAAE,KAAM,WAAY,UAAW,SAAU,CAC5D,CAAC,CACH,CACF,CAAC,EAEDN,EAAG,gDAAiD,SAAY,CAC9DK,EAAS,IAAI,kBAAkB,CAAC,CAAC,EAEjC,MAAMK,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,CAAM,EAAE,QACbf,EACE,IAAI,MACF,6EAA6EW,CAAS,EACxF,CACF,CACF,CACF,CAAC,EAEDN,EAAG,sEAAuE,SAAY,CACpFK,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAI,eACJ,SAAUH,EAA6B,QACvC,aAAc,CAAC,CACjB,CACF,CAAC,EAED,MAAMQ,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,CAAM,EAAE,QACbf,EACE,IAAI,MACF,6EAA6EW,CAAS,EACxF,CACF,CACF,CACF,CAAC,EAEDN,EAAG,yEAA0E,SAAY,CAGvFK,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUJ,EAA6B,QACvC,aAAc,CAAC,CAAE,kBAAmB,UAAW,CAAC,CAClD,CACF,CAAC,EAED,MAAMQ,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,EAAO,OAAO,CAAC,EAAE,KAAK,EAAI,EACjCX,EAAQW,EAAO,QAAQ,EAAY,OAAO,EAAE,QAC1C,IAAI,OACF,OAAO,yFAAyFJ,CAAS,GAC3G,CACF,CACF,CAAC,EAEDN,EAAG,uEAAwE,SAAY,CAKrFK,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUJ,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CAAE,MAAO,CAAC,CAAE,CAC9B,CACF,CACF,CACF,CAAC,EAED,MAAMQ,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,EAAO,OAAO,CAAC,EAAE,KAAK,EAAI,EACjCX,EAAQW,EAAO,QAAQ,EAAY,OAAO,EAAE,QAC1C,IAAI,OACF,OAAO,yFAAyFJ,CAAS,GAC3G,CACF,CACF,CAAC,EAEDN,EAAG,yEAA0E,SAAY,CACvFK,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUJ,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CACd,UAAW,EACX,UAAW,EACX,MAAO,CAAC,CAAE,OAAQ,WAAY,SAAU,QAAS,CAAC,CACpD,CACF,CACF,CACF,CACF,CAAC,EAED,MAAMQ,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClC,KAAM,CAAE,YAAAC,CAAY,EAAID,EAAO,aAAa,EAC5CX,EAAOY,EAAY,UAAU,EAAG,aAAa,CAAC,EAAE,QAC9CZ,EAAO,iBAAiB,CACtB,cAAe,CACb,UAAW,EACX,UAAW,EACX,iBAAkB,CAAE,OAAQ,SAAU,SAAU,QAAS,EACzD,MAAO,CAAC,CAAE,OAAQ,WAAY,SAAU,QAAS,CAAC,CACpD,CACF,CAAC,CACH,CACF,CAAC,EAEDC,EAAG,2CAA4C,SAAY,CACzDK,EAAS,IAAI,kBAAkB,IAAI,MAAM,SAAS,CAAC,EAEnD,MAAMK,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzER,EAAOW,CAAM,EAAE,QACbf,EACE,IAAI,MACF,iGACF,CACF,CACF,CACF,CAAC,CACH,CAAC",
-  "names": ["Left", "Right", "beforeEach", "describe", "expect", "it", "vi", "SolanaTransactionScanChainId", "HttpInstructionInfoDataSource", "datasource", "httpMock", "programId", "network", "config", "successResponse", "result", "descriptors"]
+  "sourcesContent": ["import { type DmkNetworkClient } from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { type ContextModuleServiceConfig } from \"@/config/model/ContextModuleConfig\";\nimport { SolanaTransactionScanChainId } from \"@/modules/solana/model/SolanaTransactionScanChainId\";\n\nimport { HttpInstructionInfoDataSource } from \"./HttpInstructionInfoDataSource\";\nimport {\n  type InstructionInfoDataSource,\n  SolanaProgramNotFoundError,\n} from \"./InstructionInfoDataSource\";\nimport { type CalInstructionInfoResponseDto } from \"./InstructionInfoDto\";\n\ndescribe(\"HttpInstructionInfoDataSource\", () => {\n  let datasource: InstructionInfoDataSource;\n  let httpMock: { get: ReturnType<typeof vi.fn> };\n  const programId = \"11111111111111111111111111111111\";\n  const network = \"solana-mainnet\";\n  const config: ContextModuleServiceConfig = {\n    cal: {\n      url: \"https://global.api.prd.ledger.com/cal/v1\",\n      mode: \"prod\",\n      branch: \"main\",\n    },\n  } as ContextModuleServiceConfig;\n\n  const successResponse: CalInstructionInfoResponseDto = [\n    {\n      id: programId,\n      chain_id: SolanaTransactionScanChainId.MAINNET,\n      instructions: [\n        {\n          discriminator_hex: \"00000000\",\n          instruction_name: \"createAccount\",\n          descriptor: {\n            data: \"00010101\",\n            signatures: { prod: \"prodsig\", test: \"testsig\" },\n          },\n          display_fields: [],\n          value_flow_ports: [],\n          hide_rules: [],\n          account_resets: [],\n        },\n      ],\n    },\n  ];\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    httpMock = { get: vi.fn() };\n    datasource = new HttpInstructionInfoDataSource(\n      config,\n      httpMock as unknown as DmkNetworkClient,\n    );\n  });\n\n  it(\"calls CAL /solana_programs with id, chain_id and output params\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    await datasource.getInstructionInfo({ programId, network });\n\n    expect(httpMock.get).toHaveBeenCalledTimes(1);\n    expect(httpMock.get).toHaveBeenCalledWith(\n      \"https://global.api.prd.ledger.com/cal/v1/solana_programs\",\n      {\n        params: {\n          id: programId,\n          chain_id: SolanaTransactionScanChainId.MAINNET,\n          output: \"id,chain_id,instructions\",\n          ref: \"branch:main\",\n        },\n      },\n    );\n  });\n\n  it(\"maps devnet/testnet networks to their numeric chain ids\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    await datasource.getInstructionInfo({\n      programId,\n      network: \"solana-devnet\",\n    });\n\n    expect(httpMock.get).toHaveBeenCalledWith(\n      \"https://global.api.prd.ledger.com/cal/v1/solana_programs\",\n      expect.objectContaining({\n        params: expect.objectContaining({ chain_id: 901 }),\n      }),\n    );\n  });\n\n  it(\"returns Right with each descriptor transformed into the core payload on success\", async () => {\n    httpMock.get.mockResolvedValue(successResponse);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Right({\n        programId,\n        descriptors: {\n          \"00000000\": Right({\n            programId,\n            discriminator: \"00000000\",\n            instructionName: \"createAccount\",\n            instructionInfo: { data: \"00010101\", signature: \"prodsig\" },\n            substructures: [],\n            enumVariants: [],\n            idlDescriptor: { typePool: [], rootType: 0 },\n            mintAssociations: [],\n            ownerAssociations: [],\n            valueFlowPorts: [],\n            accountResets: [],\n            displayFields: [],\n            hideRules: [],\n          }),\n        },\n        enumVariants: [],\n        basicFlowTags: [],\n      }),\n    );\n  });\n\n  it(\"keys a descriptor without `discriminator_hex` under the empty string\", async () => {\n    // Single-instruction programs (e.g. SPL Memo `addMemo`) genuinely have no\n    // discriminator, so CAL omits the field.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            instruction_name: \"addMemo\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isRight()).toBe(true);\n    const { descriptors } = result.unsafeCoerce();\n    expect(Object.keys(descriptors)).toEqual([\"\"]);\n    expect(descriptors[\"\"]!.unsafeCoerce()).toEqual(\n      expect.objectContaining({\n        programId,\n        discriminator: \"\",\n        instructionInfo: { data: \"00010101\", signature: \"prodsig\" },\n      }),\n    );\n  });\n\n  it(\"returns a SolanaProgramNotFoundError when the response array is empty\", async () => {\n    httpMock.get.mockResolvedValue([]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new SolanaProgramNotFoundError(\n          programId,\n          `[ContextModule] HttpInstructionInfoDataSource: empty response for program ${programId}`,\n        ),\n      ),\n    );\n    expect(result.extract()).toBeInstanceOf(SolanaProgramNotFoundError);\n  });\n\n  it(\"returns a plain Error, not a not-found, when the response is not an array\", async () => {\n    httpMock.get.mockResolvedValue({ unexpected: true });\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isLeft()).toBe(true);\n    expect(result.extract()).not.toBeInstanceOf(SolanaProgramNotFoundError);\n    expect((result.extract() as Error).message).toBe(\n      `[ContextModule] HttpInstructionInfoDataSource: unexpected response for program ${programId}`,\n    );\n  });\n\n  it(\"returns a SolanaProgramNotFoundError when no program object matches the requested programId\", async () => {\n    httpMock.get.mockResolvedValue([\n      {\n        id: \"OtherProgram\",\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new SolanaProgramNotFoundError(\n          programId,\n          `[ContextModule] HttpInstructionInfoDataSource: no descriptors for program ${programId}`,\n        ),\n      ),\n    );\n  });\n\n  it(\"returns Left (not a throw) when an instruction descriptor is malformed\", async () => {\n    // `descriptor` missing on the instruction \u2014 would crash the loader if the\n    // datasource handed it through unvalidated.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [{ discriminator_hex: \"00000000\" }],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isLeft()).toBe(true);\n    expect((result.extract() as Error).message).toMatch(\n      new RegExp(\n        String.raw`\\[ContextModule\\] HttpInstructionInfoDataSource: malformed descriptors for program ${programId}:`,\n      ),\n    );\n  });\n\n  it(\"returns Left (not a throw) when account_schema.slots is not an array\", async () => {\n    // Regression: account_schema was not codec-validated, so a malformed\n    // shape (e.g. `slots` as an object instead of an array) bypassed\n    // validation here and crashed later in the mapper's `.map()` call instead\n    // of degrading gracefully to a per-program error.\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            discriminator_hex: \"00000000\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n            account_schema: { slots: {} },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isLeft()).toBe(true);\n    expect((result.extract() as Error).message).toMatch(\n      new RegExp(\n        String.raw`\\[ContextModule\\] HttpInstructionInfoDataSource: malformed descriptors for program ${programId}:`,\n      ),\n    );\n  });\n\n  it(\"returns Right with accountSchema mapped through when it is well-formed\", async () => {\n    httpMock.get.mockResolvedValue([\n      {\n        id: programId,\n        chain_id: SolanaTransactionScanChainId.MAINNET,\n        instructions: [\n          {\n            discriminator_hex: \"00000000\",\n            descriptor: {\n              data: \"00010101\",\n              signatures: { prod: \"prodsig\", test: \"testsig\" },\n            },\n            account_schema: {\n              count_min: 2,\n              count_max: 2,\n              slots: [{ signer: \"REQUIRED\", writable: \"EITHER\" }],\n            },\n          },\n        ],\n      },\n    ]);\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result.isRight()).toBe(true);\n    const { descriptors } = result.unsafeCoerce();\n    expect(descriptors[\"00000000\"]!.unsafeCoerce()).toEqual(\n      expect.objectContaining({\n        accountSchema: {\n          count_min: 2,\n          count_max: 2,\n          remaining_policy: { signer: \"EITHER\", writable: \"EITHER\" },\n          slots: [{ signer: \"REQUIRED\", writable: \"EITHER\" }],\n        },\n      }),\n    );\n  });\n\n  it(\"returns Left when the HTTP client throws\", async () => {\n    httpMock.get.mockRejectedValue(new Error(\"network\"));\n\n    const result = await datasource.getInstructionInfo({ programId, network });\n\n    expect(result).toEqual(\n      Left(\n        new Error(\n          \"[ContextModule] HttpInstructionInfoDataSource: Failed to fetch instruction descriptors: network\",\n        ),\n      ),\n    );\n    expect(result.extract()).not.toBeInstanceOf(SolanaProgramNotFoundError);\n  });\n\n  describe(\"signing_route\", () => {\n    const stakeProgramId = \"Stake11111111111111111111111111111111111111\";\n    const signedDescriptor = {\n      data: \"00010101\",\n      signatures: { prod: \"prodsig\", test: \"testsig\" },\n    };\n\n    // Agreed CAL contract: `signing_route` sits on each instruction object,\n    // outside the signed `descriptor`.\n    const stakeResponse = (\n      signingRoutes: Record<string, unknown>,\n    ): CalInstructionInfoResponseDto =>\n      [\n        {\n          id: stakeProgramId,\n          chain_id: SolanaTransactionScanChainId.MAINNET,\n          instructions: Object.entries(signingRoutes).map(\n            ([discriminator_hex, signing_route]) => ({\n              discriminator_hex,\n              descriptor: signedDescriptor,\n              ...(signing_route === undefined ? {} : { signing_route }),\n            }),\n          ),\n        },\n      ] as CalInstructionInfoResponseDto;\n\n    const getStakeInfo = () =>\n      datasource.getInstructionInfo({ programId: stakeProgramId, network });\n\n    it(\"maps basic_flow tags to one entry per (discriminator, rule, role)\", async () => {\n      httpMock.get.mockResolvedValue(\n        stakeResponse({\n          \"00000000\": {\n            basic_flow: [{ rule: \"native-staking\", role: \"allowed\" }],\n          },\n          \"02000000\": {\n            basic_flow: [\n              { rule: \"native-staking\", role: \"required\" },\n              { rule: \"other-rule\", role: \"allowed\" },\n            ],\n          },\n        }),\n      );\n\n      const result = await getStakeInfo();\n\n      expect(result.unsafeCoerce().basicFlowTags).toEqual([\n        { discriminator: \"00000000\", rule: \"native-staking\", role: \"allowed\" },\n        {\n          discriminator: \"02000000\",\n          rule: \"native-staking\",\n          role: \"required\",\n        },\n        { discriminator: \"02000000\", rule: \"other-rule\", role: \"allowed\" },\n      ]);\n    });\n\n    it(\"returns no tags when CAL doesn't serve signing_route (today's CAL)\", async () => {\n      httpMock.get.mockResolvedValue(\n        stakeResponse({ \"00000000\": undefined, \"02000000\": undefined }),\n      );\n\n      const result = await getStakeInfo();\n\n      expect(result.unsafeCoerce().basicFlowTags).toEqual([]);\n    });\n\n    it(\"drops unknown roles, empty rule ids and unknown keys\", async () => {\n      httpMock.get.mockResolvedValue(\n        stakeResponse({\n          \"02000000\": {\n            basic_flow: [\n              { rule: \"native-staking\", role: \"forbidden\" },\n              { rule: \"\", role: \"required\" },\n              { rule: \"native-staking\", role: \"required\", extra: 1 },\n            ],\n            other_flow: [{ rule: \"x\", role: \"required\" }],\n          },\n        }),\n      );\n\n      const result = await getStakeInfo();\n\n      expect(result.unsafeCoerce().basicFlowTags).toEqual([\n        {\n          discriminator: \"02000000\",\n          rule: \"native-staking\",\n          role: \"required\",\n        },\n      ]);\n    });\n\n    it.each([\n      [\"a string\", \"native-staking\"],\n      [\"basic_flow not an array\", { basic_flow: { rule: \"a\" } }],\n      [\"an entry without role\", { basic_flow: [{ rule: \"native-staking\" }] }],\n      [\"a non-string rule\", { basic_flow: [{ rule: 1, role: \"required\" }] }],\n    ])(\n      \"drops a malformed signing_route (%s) but keeps the descriptors\",\n      async (_, signingRoute) => {\n        httpMock.get.mockResolvedValue(\n          stakeResponse({\n            \"00000000\": {\n              basic_flow: [{ rule: \"native-staking\", role: \"allowed\" }],\n            },\n            \"02000000\": signingRoute,\n          }),\n        );\n\n        const result = await getStakeInfo();\n\n        expect(result.isRight()).toBe(true);\n        const { descriptors, basicFlowTags } = result.unsafeCoerce();\n        expect(Object.keys(descriptors)).toEqual([\"00000000\", \"02000000\"]);\n        expect(descriptors[\"02000000\"]!.isRight()).toBe(true);\n        expect(basicFlowTags).toEqual([\n          {\n            discriminator: \"00000000\",\n            rule: \"native-staking\",\n            role: \"allowed\",\n          },\n        ]);\n      },\n    );\n\n    it(\"ignores tags on an instruction without discriminator_hex\", async () => {\n      httpMock.get.mockResolvedValue([\n        {\n          id: stakeProgramId,\n          chain_id: SolanaTransactionScanChainId.MAINNET,\n          instructions: [\n            {\n              descriptor: signedDescriptor,\n              signing_route: {\n                basic_flow: [{ rule: \"native-staking\", role: \"required\" }],\n              },\n            },\n          ],\n        },\n      ]);\n\n      const result = await getStakeInfo();\n\n      expect(result.unsafeCoerce().basicFlowTags).toEqual([]);\n    });\n  });\n\n  describe(\"cache\", () => {\n    beforeEach(() => {\n      vi.useFakeTimers();\n    });\n\n    afterEach(() => {\n      vi.useRealTimers();\n    });\n\n    it(\"serves a second call for the same program and network from the cache\", async () => {\n      httpMock.get.mockResolvedValue(successResponse);\n\n      const first = await datasource.getInstructionInfo({ programId, network });\n      const second = await datasource.getInstructionInfo({\n        programId,\n        network,\n      });\n\n      expect(httpMock.get).toHaveBeenCalledTimes(1);\n      expect(second).toBe(first);\n    });\n\n    it(\"shares one HTTP call between concurrent callers\", async () => {\n      httpMock.get.mockResolvedValue(successResponse);\n\n      await Promise.all([\n        datasource.getInstructionInfo({ programId, network }),\n        datasource.getInstructionInfo({ programId, network }),\n      ]);\n\n      expect(httpMock.get).toHaveBeenCalledTimes(1);\n    });\n\n    it(\"keys the cache by chain id\", async () => {\n      httpMock.get.mockResolvedValue(successResponse);\n\n      await datasource.getInstructionInfo({ programId, network });\n      await datasource.getInstructionInfo({\n        programId,\n        network: \"solana-devnet\",\n      });\n      // Unknown labels fall back to mainnet, so they share its entry.\n      await datasource.getInstructionInfo({ programId, network: \"unknown\" });\n\n      expect(httpMock.get).toHaveBeenCalledTimes(2);\n    });\n\n    it(\"fetches again once the entry has expired\", async () => {\n      httpMock.get.mockResolvedValue(successResponse);\n\n      await datasource.getInstructionInfo({ programId, network });\n      vi.advanceTimersByTime(30_001);\n      await datasource.getInstructionInfo({ programId, network });\n\n      expect(httpMock.get).toHaveBeenCalledTimes(2);\n    });\n\n    it(\"evicts the oldest entry beyond the size cap\", async () => {\n      httpMock.get.mockImplementation(\n        (_url: string, { params }: { params: { id: string } }) =>\n          Promise.resolve([\n            { ...successResponse[0]!, id: params.id },\n          ] as CalInstructionInfoResponseDto),\n      );\n      const ids = Array.from({ length: 65 }, (_, i) => `program-${i}`);\n\n      for (const id of ids) {\n        await datasource.getInstructionInfo({ programId: id, network });\n      }\n      // The most recent entry is still cached, the oldest was evicted.\n      await datasource.getInstructionInfo({ programId: ids[64]!, network });\n      expect(httpMock.get).toHaveBeenCalledTimes(65);\n      await datasource.getInstructionInfo({ programId: ids[0]!, network });\n      expect(httpMock.get).toHaveBeenCalledTimes(66);\n    });\n\n    it.each([\n      [\"the HTTP client throws\", () => Promise.reject(new Error(\"network\"))],\n      [\n        \"the program is malformed\",\n        () =>\n          Promise.resolve([\n            { id: programId, chain_id: 900, instructions: [{}] },\n          ]),\n      ],\n    ])(\"does not cache a failure (%s)\", async (_, failingGet) => {\n      httpMock.get\n        .mockImplementationOnce(failingGet)\n        .mockResolvedValue(successResponse);\n\n      const first = await datasource.getInstructionInfo({ programId, network });\n      const second = await datasource.getInstructionInfo({\n        programId,\n        network,\n      });\n\n      expect(first.isLeft()).toBe(true);\n      expect(second.isRight()).toBe(true);\n      expect(httpMock.get).toHaveBeenCalledTimes(2);\n    });\n\n    it(\"caches a program-not-found answer\", async () => {\n      httpMock.get.mockResolvedValue([]);\n\n      await datasource.getInstructionInfo({ programId, network });\n      const second = await datasource.getInstructionInfo({\n        programId,\n        network,\n      });\n\n      expect(second.extract()).toBeInstanceOf(SolanaProgramNotFoundError);\n      expect(httpMock.get).toHaveBeenCalledTimes(1);\n    });\n  });\n});\n"],
+  "mappings": "AACA,OAAS,QAAAA,EAAM,SAAAC,MAAa,YAC5B,OAAS,aAAAC,EAAW,cAAAC,EAAY,YAAAC,EAAU,UAAAC,EAAQ,MAAAC,EAAI,MAAAC,MAAU,SAGhE,OAAS,gCAAAC,MAAoC,sDAE7C,OAAS,iCAAAC,MAAqC,kCAC9C,OAEE,8BAAAC,MACK,8BAGPN,EAAS,gCAAiC,IAAM,CAC9C,IAAIO,EACAC,EACJ,MAAMC,EAAY,mCACZC,EAAU,iBACVC,EAAqC,CACzC,IAAK,CACH,IAAK,2CACL,KAAM,OACN,OAAQ,MACV,CACF,EAEMC,EAAiD,CACrD,CACE,GAAIH,EACJ,SAAUL,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,iBAAkB,gBAClB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CAAC,EACjB,iBAAkB,CAAC,EACnB,WAAY,CAAC,EACb,eAAgB,CAAC,CACnB,CACF,CACF,CACF,EAEAL,EAAW,IAAM,CACfI,EAAG,cAAc,EACjBK,EAAW,CAAE,IAAKL,EAAG,GAAG,CAAE,EAC1BI,EAAa,IAAIF,EACfM,EACAH,CACF,CACF,CAAC,EAEDN,EAAG,iEAAkE,SAAY,CAC/EM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAE1DT,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,EAC5CP,EAAOO,EAAS,GAAG,EAAE,qBACnB,2DACA,CACE,OAAQ,CACN,GAAIC,EACJ,SAAUL,EAA6B,QACvC,OAAQ,2BACR,IAAK,aACP,CACF,CACF,CACF,CAAC,EAEDF,EAAG,0DAA2D,SAAY,CACxEM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAClC,UAAAE,EACA,QAAS,eACX,CAAC,EAEDR,EAAOO,EAAS,GAAG,EAAE,qBACnB,2DACAP,EAAO,iBAAiB,CACtB,OAAQA,EAAO,iBAAiB,CAAE,SAAU,GAAI,CAAC,CACnD,CAAC,CACH,CACF,CAAC,EAEDC,EAAG,kFAAmF,SAAY,CAChGM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAMC,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,CAAM,EAAE,QACbhB,EAAM,CACJ,UAAAY,EACA,YAAa,CACX,WAAYZ,EAAM,CAChB,UAAAY,EACA,cAAe,WACf,gBAAiB,gBACjB,gBAAiB,CAAE,KAAM,WAAY,UAAW,SAAU,EAC1D,cAAe,CAAC,EAChB,aAAc,CAAC,EACf,cAAe,CAAE,SAAU,CAAC,EAAG,SAAU,CAAE,EAC3C,iBAAkB,CAAC,EACnB,kBAAmB,CAAC,EACpB,eAAgB,CAAC,EACjB,cAAe,CAAC,EAChB,cAAe,CAAC,EAChB,UAAW,CAAC,CACd,CAAC,CACH,EACA,aAAc,CAAC,EACf,cAAe,CAAC,CAClB,CAAC,CACH,CACF,CAAC,EAEDP,EAAG,uEAAwE,SAAY,CAGrFM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUL,EAA6B,QACvC,aAAc,CACZ,CACE,iBAAkB,UAClB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,CACF,CACF,CACF,CACF,CAAC,EAED,MAAMS,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClC,KAAM,CAAE,YAAAC,CAAY,EAAID,EAAO,aAAa,EAC5CZ,EAAO,OAAO,KAAKa,CAAW,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAC7Cb,EAAOa,EAAY,EAAE,EAAG,aAAa,CAAC,EAAE,QACtCb,EAAO,iBAAiB,CACtB,UAAAQ,EACA,cAAe,GACf,gBAAiB,CAAE,KAAM,WAAY,UAAW,SAAU,CAC5D,CAAC,CACH,CACF,CAAC,EAEDP,EAAG,wEAAyE,SAAY,CACtFM,EAAS,IAAI,kBAAkB,CAAC,CAAC,EAEjC,MAAMK,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,CAAM,EAAE,QACbjB,EACE,IAAIU,EACFG,EACA,6EAA6EA,CAAS,EACxF,CACF,CACF,EACAR,EAAOY,EAAO,QAAQ,CAAC,EAAE,eAAeP,CAA0B,CACpE,CAAC,EAEDJ,EAAG,4EAA6E,SAAY,CAC1FM,EAAS,IAAI,kBAAkB,CAAE,WAAY,EAAK,CAAC,EAEnD,MAAMK,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,EAAO,OAAO,CAAC,EAAE,KAAK,EAAI,EACjCZ,EAAOY,EAAO,QAAQ,CAAC,EAAE,IAAI,eAAeP,CAA0B,EACtEL,EAAQY,EAAO,QAAQ,EAAY,OAAO,EAAE,KAC1C,kFAAkFJ,CAAS,EAC7F,CACF,CAAC,EAEDP,EAAG,8FAA+F,SAAY,CAC5GM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAI,eACJ,SAAUJ,EAA6B,QACvC,aAAc,CAAC,CACjB,CACF,CAAC,EAED,MAAMS,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,CAAM,EAAE,QACbjB,EACE,IAAIU,EACFG,EACA,6EAA6EA,CAAS,EACxF,CACF,CACF,CACF,CAAC,EAEDP,EAAG,yEAA0E,SAAY,CAGvFM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUL,EAA6B,QACvC,aAAc,CAAC,CAAE,kBAAmB,UAAW,CAAC,CAClD,CACF,CAAC,EAED,MAAMS,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,EAAO,OAAO,CAAC,EAAE,KAAK,EAAI,EACjCZ,EAAQY,EAAO,QAAQ,EAAY,OAAO,EAAE,QAC1C,IAAI,OACF,OAAO,yFAAyFJ,CAAS,GAC3G,CACF,CACF,CAAC,EAEDP,EAAG,uEAAwE,SAAY,CAKrFM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUL,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CAAE,MAAO,CAAC,CAAE,CAC9B,CACF,CACF,CACF,CAAC,EAED,MAAMS,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,EAAO,OAAO,CAAC,EAAE,KAAK,EAAI,EACjCZ,EAAQY,EAAO,QAAQ,EAAY,OAAO,EAAE,QAC1C,IAAI,OACF,OAAO,yFAAyFJ,CAAS,GAC3G,CACF,CACF,CAAC,EAEDP,EAAG,yEAA0E,SAAY,CACvFM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIC,EACJ,SAAUL,EAA6B,QACvC,aAAc,CACZ,CACE,kBAAmB,WACnB,WAAY,CACV,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EACA,eAAgB,CACd,UAAW,EACX,UAAW,EACX,MAAO,CAAC,CAAE,OAAQ,WAAY,SAAU,QAAS,CAAC,CACpD,CACF,CACF,CACF,CACF,CAAC,EAED,MAAMS,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClC,KAAM,CAAE,YAAAC,CAAY,EAAID,EAAO,aAAa,EAC5CZ,EAAOa,EAAY,UAAU,EAAG,aAAa,CAAC,EAAE,QAC9Cb,EAAO,iBAAiB,CACtB,cAAe,CACb,UAAW,EACX,UAAW,EACX,iBAAkB,CAAE,OAAQ,SAAU,SAAU,QAAS,EACzD,MAAO,CAAC,CAAE,OAAQ,WAAY,SAAU,QAAS,CAAC,CACpD,CACF,CAAC,CACH,CACF,CAAC,EAEDC,EAAG,2CAA4C,SAAY,CACzDM,EAAS,IAAI,kBAAkB,IAAI,MAAM,SAAS,CAAC,EAEnD,MAAMK,EAAS,MAAMN,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAEzET,EAAOY,CAAM,EAAE,QACbjB,EACE,IAAI,MACF,iGACF,CACF,CACF,EACAK,EAAOY,EAAO,QAAQ,CAAC,EAAE,IAAI,eAAeP,CAA0B,CACxE,CAAC,EAEDN,EAAS,gBAAiB,IAAM,CAC9B,MAAMe,EAAiB,8CACjBC,EAAmB,CACvB,KAAM,WACN,WAAY,CAAE,KAAM,UAAW,KAAM,SAAU,CACjD,EAIMC,EACJC,GAEA,CACE,CACE,GAAIH,EACJ,SAAUX,EAA6B,QACvC,aAAc,OAAO,QAAQc,CAAa,EAAE,IAC1C,CAAC,CAACC,EAAmBC,CAAa,KAAO,CACvC,kBAAAD,EACA,WAAYH,EACZ,GAAII,IAAkB,OAAY,CAAC,EAAI,CAAE,cAAAA,CAAc,CACzD,EACF,CACF,CACF,EAEIC,EAAe,IACnBd,EAAW,mBAAmB,CAAE,UAAWQ,EAAgB,QAAAL,CAAQ,CAAC,EAEtER,EAAG,oEAAqE,SAAY,CAClFM,EAAS,IAAI,kBACXS,EAAc,CACZ,WAAY,CACV,WAAY,CAAC,CAAE,KAAM,iBAAkB,KAAM,SAAU,CAAC,CAC1D,EACA,WAAY,CACV,WAAY,CACV,CAAE,KAAM,iBAAkB,KAAM,UAAW,EAC3C,CAAE,KAAM,aAAc,KAAM,SAAU,CACxC,CACF,CACF,CAAC,CACH,EAEA,MAAMJ,EAAS,MAAMQ,EAAa,EAElCpB,EAAOY,EAAO,aAAa,EAAE,aAAa,EAAE,QAAQ,CAClD,CAAE,cAAe,WAAY,KAAM,iBAAkB,KAAM,SAAU,EACrE,CACE,cAAe,WACf,KAAM,iBACN,KAAM,UACR,EACA,CAAE,cAAe,WAAY,KAAM,aAAc,KAAM,SAAU,CACnE,CAAC,CACH,CAAC,EAEDX,EAAG,qEAAsE,SAAY,CACnFM,EAAS,IAAI,kBACXS,EAAc,CAAE,WAAY,OAAW,WAAY,MAAU,CAAC,CAChE,EAEA,MAAMJ,EAAS,MAAMQ,EAAa,EAElCpB,EAAOY,EAAO,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CACxD,CAAC,EAEDX,EAAG,uDAAwD,SAAY,CACrEM,EAAS,IAAI,kBACXS,EAAc,CACZ,WAAY,CACV,WAAY,CACV,CAAE,KAAM,iBAAkB,KAAM,WAAY,EAC5C,CAAE,KAAM,GAAI,KAAM,UAAW,EAC7B,CAAE,KAAM,iBAAkB,KAAM,WAAY,MAAO,CAAE,CACvD,EACA,WAAY,CAAC,CAAE,KAAM,IAAK,KAAM,UAAW,CAAC,CAC9C,CACF,CAAC,CACH,EAEA,MAAMJ,EAAS,MAAMQ,EAAa,EAElCpB,EAAOY,EAAO,aAAa,EAAE,aAAa,EAAE,QAAQ,CAClD,CACE,cAAe,WACf,KAAM,iBACN,KAAM,UACR,CACF,CAAC,CACH,CAAC,EAEDX,EAAG,KAAK,CACN,CAAC,WAAY,gBAAgB,EAC7B,CAAC,0BAA2B,CAAE,WAAY,CAAE,KAAM,GAAI,CAAE,CAAC,EACzD,CAAC,wBAAyB,CAAE,WAAY,CAAC,CAAE,KAAM,gBAAiB,CAAC,CAAE,CAAC,EACtE,CAAC,oBAAqB,CAAE,WAAY,CAAC,CAAE,KAAM,EAAG,KAAM,UAAW,CAAC,CAAE,CAAC,CACvE,CAAC,EACC,iEACA,MAAOoB,EAAGC,IAAiB,CACzBf,EAAS,IAAI,kBACXS,EAAc,CACZ,WAAY,CACV,WAAY,CAAC,CAAE,KAAM,iBAAkB,KAAM,SAAU,CAAC,CAC1D,EACA,WAAYM,CACd,CAAC,CACH,EAEA,MAAMV,EAAS,MAAMQ,EAAa,EAElCpB,EAAOY,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClC,KAAM,CAAE,YAAAC,EAAa,cAAAU,CAAc,EAAIX,EAAO,aAAa,EAC3DZ,EAAO,OAAO,KAAKa,CAAW,CAAC,EAAE,QAAQ,CAAC,WAAY,UAAU,CAAC,EACjEb,EAAOa,EAAY,UAAU,EAAG,QAAQ,CAAC,EAAE,KAAK,EAAI,EACpDb,EAAOuB,CAAa,EAAE,QAAQ,CAC5B,CACE,cAAe,WACf,KAAM,iBACN,KAAM,SACR,CACF,CAAC,CACH,CACF,EAEAtB,EAAG,2DAA4D,SAAY,CACzEM,EAAS,IAAI,kBAAkB,CAC7B,CACE,GAAIO,EACJ,SAAUX,EAA6B,QACvC,aAAc,CACZ,CACE,WAAYY,EACZ,cAAe,CACb,WAAY,CAAC,CAAE,KAAM,iBAAkB,KAAM,UAAW,CAAC,CAC3D,CACF,CACF,CACF,CACF,CAAC,EAED,MAAMH,EAAS,MAAMQ,EAAa,EAElCpB,EAAOY,EAAO,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CACxD,CAAC,CACH,CAAC,EAEDb,EAAS,QAAS,IAAM,CACtBD,EAAW,IAAM,CACfI,EAAG,cAAc,CACnB,CAAC,EAEDL,EAAU,IAAM,CACdK,EAAG,cAAc,CACnB,CAAC,EAEDD,EAAG,uEAAwE,SAAY,CACrFM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAMa,EAAQ,MAAMlB,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAClEgB,EAAS,MAAMnB,EAAW,mBAAmB,CACjD,UAAAE,EACA,QAAAC,CACF,CAAC,EAEDT,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,EAC5CP,EAAOyB,CAAM,EAAE,KAAKD,CAAK,CAC3B,CAAC,EAEDvB,EAAG,kDAAmD,SAAY,CAChEM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAM,QAAQ,IAAI,CAChBL,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EACpDH,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,CACtD,CAAC,EAEDT,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,CAC9C,CAAC,EAEDN,EAAG,6BAA8B,SAAY,CAC3CM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAC1D,MAAMH,EAAW,mBAAmB,CAClC,UAAAE,EACA,QAAS,eACX,CAAC,EAED,MAAMF,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAS,SAAU,CAAC,EAErER,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,CAC9C,CAAC,EAEDN,EAAG,2CAA4C,SAAY,CACzDM,EAAS,IAAI,kBAAkBI,CAAe,EAE9C,MAAML,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAC1DP,EAAG,oBAAoB,KAAM,EAC7B,MAAMI,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAE1DT,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,CAC9C,CAAC,EAEDN,EAAG,8CAA+C,SAAY,CAC5DM,EAAS,IAAI,mBACX,CAACmB,EAAc,CAAE,OAAAC,CAAO,IACtB,QAAQ,QAAQ,CACd,CAAE,GAAGhB,EAAgB,CAAC,EAAI,GAAIgB,EAAO,EAAG,CAC1C,CAAkC,CACtC,EACA,MAAMC,EAAM,MAAM,KAAK,CAAE,OAAQ,EAAG,EAAG,CAACP,EAAGQ,IAAM,WAAWA,CAAC,EAAE,EAE/D,UAAWC,KAAMF,EACf,MAAMtB,EAAW,mBAAmB,CAAE,UAAWwB,EAAI,QAAArB,CAAQ,CAAC,EAGhE,MAAMH,EAAW,mBAAmB,CAAE,UAAWsB,EAAI,EAAE,EAAI,QAAAnB,CAAQ,CAAC,EACpET,EAAOO,EAAS,GAAG,EAAE,sBAAsB,EAAE,EAC7C,MAAMD,EAAW,mBAAmB,CAAE,UAAWsB,EAAI,CAAC,EAAI,QAAAnB,CAAQ,CAAC,EACnET,EAAOO,EAAS,GAAG,EAAE,sBAAsB,EAAE,CAC/C,CAAC,EAEDN,EAAG,KAAK,CACN,CAAC,yBAA0B,IAAM,QAAQ,OAAO,IAAI,MAAM,SAAS,CAAC,CAAC,EACrE,CACE,2BACA,IACE,QAAQ,QAAQ,CACd,CAAE,GAAIO,EAAW,SAAU,IAAK,aAAc,CAAC,CAAC,CAAC,CAAE,CACrD,CAAC,CACL,CACF,CAAC,EAAE,gCAAiC,MAAOa,EAAGU,IAAe,CAC3DxB,EAAS,IACN,uBAAuBwB,CAAU,EACjC,kBAAkBpB,CAAe,EAEpC,MAAMa,EAAQ,MAAMlB,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAClEgB,EAAS,MAAMnB,EAAW,mBAAmB,CACjD,UAAAE,EACA,QAAAC,CACF,CAAC,EAEDT,EAAOwB,EAAM,OAAO,CAAC,EAAE,KAAK,EAAI,EAChCxB,EAAOyB,EAAO,QAAQ,CAAC,EAAE,KAAK,EAAI,EAClCzB,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,CAC9C,CAAC,EAEDN,EAAG,oCAAqC,SAAY,CAClDM,EAAS,IAAI,kBAAkB,CAAC,CAAC,EAEjC,MAAMD,EAAW,mBAAmB,CAAE,UAAAE,EAAW,QAAAC,CAAQ,CAAC,EAC1D,MAAMgB,EAAS,MAAMnB,EAAW,mBAAmB,CACjD,UAAAE,EACA,QAAAC,CACF,CAAC,EAEDT,EAAOyB,EAAO,QAAQ,CAAC,EAAE,eAAepB,CAA0B,EAClEL,EAAOO,EAAS,GAAG,EAAE,sBAAsB,CAAC,CAC9C,CAAC,CACH,CAAC,CACH,CAAC",
+  "names": ["Left", "Right", "afterEach", "beforeEach", "describe", "expect", "it", "vi", "SolanaTransactionScanChainId", "HttpInstructionInfoDataSource", "SolanaProgramNotFoundError", "datasource", "httpMock", "programId", "network", "config", "successResponse", "result", "descriptors", "stakeProgramId", "signedDescriptor", "stakeResponse", "signingRoutes", "discriminator_hex", "signing_route", "getStakeInfo", "_", "signingRoute", "basicFlowTags", "first", "second", "_url", "params", "ids", "i", "id", "failingGet"]
 }

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoDataSource.js CHANGED Viewed

	@@ -1 +1,2 @@
1	+ class n extends Error{programId;constructor(r,o){super(o),this.name="SolanaProgramNotFoundError",this.programId=r}}export{n as SolanaProgramNotFoundError};
1 2	//# sourceMappingURL=InstructionInfoDataSource.js.map

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoDataSource.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
+  "sources": ["../../../../../../../src/modules/solana/instruction-info/data/InstructionInfoDataSource.ts"],
+  "sourcesContent": ["import { type Either } from \"purify-ts\";\n\nimport {\n  type SolanaInstructionEnumVariant,\n  type SolanaInstructionInfoPayload,\n} from \"@/modules/solana/model/SolanaPayloads\";\n\nexport type GetInstructionInfoParams = {\n  programId: string;\n  network: string;\n};\n\n/**\n * Result of one CAL call for a single `programId`, fully transformed into core\n * models so consumers never see the CAL DTO shapes.\n *\n * - `descriptors` is indexed by discriminator hex (multiple entries when a\n *   program defines several instructions). Each is the decoded\n *   {@link SolanaInstructionInfoPayload}, or a `Left` when that descriptor could\n *   not be decoded (e.g. no signature for the configured CAL mode) so the\n *   consumer can surface a per-descriptor error.\n * - `enumVariants` is the program-wide flat list of decoded enum variants,\n *   resolved independently of per-descriptor signature validity.\n * - `basicFlowTags` lists the instructions' `signing_route.basic_flow`\n *   tags, one entry per (discriminator, rule, role).\n */\nexport type InstructionInfoResult = {\n  programId: string;\n  descriptors: Record<string, Either<Error, SolanaInstructionInfoPayload>>;\n  enumVariants: SolanaInstructionEnumVariant[];\n  basicFlowTags: SolanaBasicFlowTag[];\n};\n\n/**\n * Tags one instruction (by discriminator hex) as part of a basic-flow rule.\n * Only instructions with a discriminator carry tags.\n */\nexport type SolanaBasicFlowTag = {\n  discriminator: string;\n  rule: string;\n  role: \"required\" | \"allowed\";\n};\n\n/**\n * Returned when CAL answers but has no entry for the program, as opposed to a\n * transport, HTTP or validation failure.\n */\nexport class SolanaProgramNotFoundError extends Error {\n  readonly programId: string;\n\n  constructor(programId: string, message: string) {\n    super(message);\n    this.name = \"SolanaProgramNotFoundError\";\n    this.programId = programId;\n  }\n}\n\nexport interface InstructionInfoDataSource {\n  /**\n   * Fetch all instruction descriptors for one Solana program from CAL.\n   * One HTTP call per `programId`; consumers fan out across multiple\n   * `programId`s in parallel.\n   */\n  getInstructionInfo(\n    params: GetInstructionInfoParams,\n  ): Promise<Either<Error, InstructionInfoResult>>;\n}\n"],
+  "mappings": "AA+CO,MAAMA,UAAmC,KAAM,CAC3C,UAET,YAAYC,EAAmBC,EAAiB,CAC9C,MAAMA,CAAO,EACb,KAAK,KAAO,6BACZ,KAAK,UAAYD,CACnB,CACF",
+  "names": ["SolanaProgramNotFoundError", "programId", "message"]
 }

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoDto.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{array as o,Codec as n,number as a,optional as t,record as i,string as e}from"purify-ts";const l=n.interface({prod:t(e),test:t(e)}),c=n.interface({data:e,signatures:l}),u=n.interface({descriptor:c}),r=n.interface({descriptor:e}),s=n.interface({signer:e,writable:e}),p=n.interface({count_min:t(a),count_max:t(a),remaining_policy:t(s),slots:t(o(s))}),d=n.interface({discriminator_hex:t(e),descriptor:c,enum_variants:t(i(e,i(e,u))),display_fields:t(o(r)),value_flow_ports:t(o(r)),hide_rules:t(o(r)),account_resets:t(o(r)),account_schema:t(p)}),_=n.interface({id:e,chain_id:a,instructions:o(d)});export{_ as calInstructionProgramCodec};
+import{array as o,Codec as n,number as i,optional as t,record as a,string as e}from"purify-ts";const l=n.interface({prod:t(e),test:t(e)}),c=n.interface({data:e,signatures:l}),u=n.interface({descriptor:c}),r=n.interface({descriptor:e}),s=n.interface({signer:e,writable:e}),p=n.interface({count_min:t(i),count_max:t(i),remaining_policy:t(s),slots:t(o(s))}),d=n.interface({discriminator_hex:t(e),descriptor:c,enum_variants:t(a(e,a(e,u))),display_fields:t(o(r)),value_flow_ports:t(o(r)),hide_rules:t(o(r)),account_resets:t(o(r)),account_schema:t(p)}),C=n.interface({basic_flow:t(o(n.interface({rule:e,role:e})))}),_=n.interface({id:e,chain_id:i,instructions:o(d)});export{_ as calInstructionProgramCodec,C as calSigningRouteCodec};
 //# sourceMappingURL=InstructionInfoDto.js.map

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoDto.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/data/InstructionInfoDto.ts"],
-  "sourcesContent": ["// DTO + codecs for the CAL instruction-descriptors response (one object per\n// `programId`, wrapped in a JSON array).\n//\n// The hand-written types describe the consumed shape (with genuinely optional\n// `?:` fields); the codecs below validate that shape at runtime so\n// `HttpInstructionInfoDataSource` can hand the loaders a payload they can\n// dereference without runtime-throwing on a malformed descriptor.\n\nimport { array, Codec, number, optional, record, string } from \"purify-ts\";\n\nexport type CalSignatures = {\n  prod?: string;\n  test?: string;\n};\n\nexport type CalSignedDescriptorDto = {\n  data: string;\n  signatures: CalSignatures;\n};\n\n// Decoded CAL JSON shapes (snake_case mirrors the CAL response) that drive\n// host-side requirement building.\n\nexport type CalValueDto = {\n  source: string;\n  account_index?: number;\n  data?: string;\n  path?: { steps: number[] };\n};\n\nexport type CalTokenValueDto = {\n  kind: string;\n  value?: CalValueDto;\n  account_index?: number;\n  /** `RESOLVE` only: account index whose address is the mint of last resort. */\n  fallback_account?: number;\n};\n\nexport type CalMintAssociationDto = {\n  account_index: number;\n  mint_index: number;\n};\n\n// Neither half is codec-validated, and the spec requires both or neither, so\n// both are optional here and the mapper drops a half-declared pair.\nexport type CalOwnerAssociationDto = {\n  account_index?: number;\n  owner?: CalValueDto;\n};\n\n/** One `ACTIVE_WHEN` predicate: a bare name, or `MINT_PREDICATE` + its mint. */\nexport type CalActiveWhenPredicateDto =\n  | string\n  | { kind: string; mint?: string };\n\nexport type CalTypePoolEntryDto = {\n  index: number;\n  kind: string;\n  refs?: number[];\n  size?: number;\n  encoding?: number;\n  len_kind?: string;\n  flag_kind?: string;\n  sentinel?: string;\n  disc_kind?: string;\n  total_variants?: number;\n  enum_id?: string;\n};\n\nexport type CalEnumVariantDto = {\n  variant_name: string;\n  payload_kind?: string;\n  descriptor: CalSignedDescriptorDto;\n};\n\n/** A substructure CAL serves only as opaque TLV (e.g. HIDE_RULE). */\nexport type CalSubstructureDto = {\n  descriptor: string;\n};\n\nexport type CalValueFlowPortDto = CalSubstructureDto & {\n  account_indices: number[];\n  optional_account_strategy?: string;\n  token_value: CalTokenValueDto;\n  active_when?: CalActiveWhenPredicateDto[];\n};\n\nexport type CalHideRuleDto = CalSubstructureDto & {\n  rule_set_index?: number;\n  target?: CalValueDto;\n  condition?: string;\n};\n\nexport type CalAccountResetDto = CalSubstructureDto & {\n  account_index?: number;\n  require_pre_balance_zero?: boolean;\n  value_kind?: string;\n  token?: CalTokenValueDto;\n  require_native_pre_balance_zero?: boolean;\n};\n\nexport type CalSlotConstraintDto = {\n  signer: string;\n  writable: string;\n};\n\nexport type CalAccountSchemaDto = {\n  count_min?: number;\n  count_max?: number;\n  remaining_policy?: CalSlotConstraintDto;\n  slots?: CalSlotConstraintDto[];\n};\n\nexport type CalDisplayFieldDto = CalSubstructureDto & {\n  name?: string;\n  param?: { type: string; value?: CalValueDto; token?: CalValueDto };\n};\n\nexport type CalInstructionDescriptorDto = {\n  discriminator_hex?: string;\n  instruction_name?: string;\n  descriptor: CalSignedDescriptorDto;\n  idl_descriptor?: {\n    type_pool?: CalTypePoolEntryDto[];\n    root_type?: number;\n  };\n  mint_association?: CalMintAssociationDto;\n  owner_association?: CalOwnerAssociationDto;\n  enum_variants?: Record<string, Record<string, CalEnumVariantDto>>;\n  display_fields?: CalDisplayFieldDto[];\n  value_flow_ports?: CalValueFlowPortDto[];\n  hide_rules?: CalHideRuleDto[];\n  account_resets?: CalAccountResetDto[];\n  /** Absent means \"no ACCOUNT_SCHEMA check\". */\n  account_schema?: CalAccountSchemaDto;\n};\n\n// One program object of the `solana_programs` response: the program `id`, its\n// `chain_id`, and the flat `instructions` array (keyed downstream by\n// `discriminator_hex`).\nexport type CalInstructionProgramDto = {\n  id: string;\n  chain_id: number;\n  instructions: CalInstructionDescriptorDto[];\n};\n\n// Outer shape: array of program objects (one per requested `id`).\nexport type CalInstructionInfoResponseDto = CalInstructionProgramDto[];\n\n// --- Validation codecs (runtime). Validate only the fields the loaders read;\n// `Codec.interface` ignores unknown extras so CAL can add fields freely. ---\n\nconst calSignaturesCodec = Codec.interface({\n  prod: optional(string),\n  test: optional(string),\n});\n\nconst calSignedDescriptorCodec = Codec.interface({\n  data: string,\n  signatures: calSignaturesCodec,\n});\n\nconst calEnumVariantCodec = Codec.interface({\n  descriptor: calSignedDescriptorCodec,\n});\n\nconst calSubstructureCodec = Codec.interface({\n  descriptor: string,\n});\n\nconst calSlotConstraintCodec = Codec.interface({\n  signer: string,\n  writable: string,\n});\n\nconst calAccountSchemaCodec = Codec.interface({\n  count_min: optional(number),\n  count_max: optional(number),\n  remaining_policy: optional(calSlotConstraintCodec),\n  slots: optional(array(calSlotConstraintCodec)),\n});\n\nconst calInstructionDescriptorCodec = Codec.interface({\n  discriminator_hex: optional(string),\n  descriptor: calSignedDescriptorCodec,\n  enum_variants: optional(record(string, record(string, calEnumVariantCodec))),\n  display_fields: optional(array(calSubstructureCodec)),\n  value_flow_ports: optional(array(calSubstructureCodec)),\n  hide_rules: optional(array(calSubstructureCodec)),\n  account_resets: optional(array(calSubstructureCodec)),\n  account_schema: optional(calAccountSchemaCodec),\n});\n\n/**\n * Codec for one program object of the `solana_programs` response. Used by the\n * datasource to validate the CAL payload before handing it to the loaders.\n * Only loader-consumed fields are validated; unrelated CAL fields\n * (`idl_descriptor`, `mint_association`, \u2026) are ignored.\n */\nexport const calInstructionProgramCodec = Codec.interface({\n  id: string,\n  chain_id: number,\n  instructions: array(calInstructionDescriptorCodec),\n});\n"],
-  "mappings": "AAQA,OAAS,SAAAA,EAAO,SAAAC,EAAO,UAAAC,EAAQ,YAAAC,EAAU,UAAAC,EAAQ,UAAAC,MAAc,YAgJ/D,MAAMC,EAAqBL,EAAM,UAAU,CACzC,KAAME,EAASE,CAAM,EACrB,KAAMF,EAASE,CAAM,CACvB,CAAC,EAEKE,EAA2BN,EAAM,UAAU,CAC/C,KAAMI,EACN,WAAYC,CACd,CAAC,EAEKE,EAAsBP,EAAM,UAAU,CAC1C,WAAYM,CACd,CAAC,EAEKE,EAAuBR,EAAM,UAAU,CAC3C,WAAYI,CACd,CAAC,EAEKK,EAAyBT,EAAM,UAAU,CAC7C,OAAQI,EACR,SAAUA,CACZ,CAAC,EAEKM,EAAwBV,EAAM,UAAU,CAC5C,UAAWE,EAASD,CAAM,EAC1B,UAAWC,EAASD,CAAM,EAC1B,iBAAkBC,EAASO,CAAsB,EACjD,MAAOP,EAASH,EAAMU,CAAsB,CAAC,CAC/C,CAAC,EAEKE,EAAgCX,EAAM,UAAU,CACpD,kBAAmBE,EAASE,CAAM,EAClC,WAAYE,EACZ,cAAeJ,EAASC,EAAOC,EAAQD,EAAOC,EAAQG,CAAmB,CAAC,CAAC,EAC3E,eAAgBL,EAASH,EAAMS,CAAoB,CAAC,EACpD,iBAAkBN,EAASH,EAAMS,CAAoB,CAAC,EACtD,WAAYN,EAASH,EAAMS,CAAoB,CAAC,EAChD,eAAgBN,EAASH,EAAMS,CAAoB,CAAC,EACpD,eAAgBN,EAASQ,CAAqB,CAChD,CAAC,EAQYE,EAA6BZ,EAAM,UAAU,CACxD,GAAII,EACJ,SAAUH,EACV,aAAcF,EAAMY,CAA6B,CACnD,CAAC",
-  "names": ["array", "Codec", "number", "optional", "record", "string", "calSignaturesCodec", "calSignedDescriptorCodec", "calEnumVariantCodec", "calSubstructureCodec", "calSlotConstraintCodec", "calAccountSchemaCodec", "calInstructionDescriptorCodec", "calInstructionProgramCodec"]
+  "sourcesContent": ["// DTO + codecs for the CAL instruction-descriptors response (one object per\n// `programId`, wrapped in a JSON array).\n//\n// The hand-written types describe the consumed shape (with genuinely optional\n// `?:` fields); the codecs below validate that shape at runtime so\n// `HttpInstructionInfoDataSource` can hand the loaders a payload they can\n// dereference without runtime-throwing on a malformed descriptor.\n\nimport { array, Codec, number, optional, record, string } from \"purify-ts\";\n\nexport type CalSignatures = {\n  prod?: string;\n  test?: string;\n};\n\nexport type CalSignedDescriptorDto = {\n  data: string;\n  signatures: CalSignatures;\n};\n\n// Decoded CAL JSON shapes (snake_case mirrors the CAL response) that drive\n// host-side requirement building.\n\nexport type CalValueDto = {\n  source: string;\n  account_index?: number;\n  data?: string;\n  path?: { steps: number[] };\n};\n\nexport type CalTokenValueDto = {\n  kind: string;\n  value?: CalValueDto;\n  account_index?: number;\n  /** `RESOLVE` only: account index whose address is the mint of last resort. */\n  fallback_account?: number;\n};\n\nexport type CalMintAssociationDto = {\n  account_index: number;\n  mint_index: number;\n};\n\n// Neither half is codec-validated, and the spec requires both or neither, so\n// both are optional here and the mapper drops a half-declared pair.\nexport type CalOwnerAssociationDto = {\n  account_index?: number;\n  owner?: CalValueDto;\n};\n\n/** One `ACTIVE_WHEN` predicate: a bare name, or `MINT_PREDICATE` + its mint. */\nexport type CalActiveWhenPredicateDto =\n  | string\n  | { kind: string; mint?: string };\n\nexport type CalTypePoolEntryDto = {\n  index: number;\n  kind: string;\n  refs?: number[];\n  size?: number;\n  encoding?: number;\n  len_kind?: string;\n  flag_kind?: string;\n  sentinel?: string;\n  disc_kind?: string;\n  total_variants?: number;\n  enum_id?: string;\n};\n\nexport type CalEnumVariantDto = {\n  variant_name: string;\n  payload_kind?: string;\n  descriptor: CalSignedDescriptorDto;\n};\n\n/** A substructure CAL serves only as opaque TLV (e.g. HIDE_RULE). */\nexport type CalSubstructureDto = {\n  descriptor: string;\n};\n\nexport type CalValueFlowPortDto = CalSubstructureDto & {\n  account_indices: number[];\n  optional_account_strategy?: string;\n  token_value: CalTokenValueDto;\n  active_when?: CalActiveWhenPredicateDto[];\n};\n\nexport type CalHideRuleDto = CalSubstructureDto & {\n  rule_set_index?: number;\n  target?: CalValueDto;\n  condition?: string;\n};\n\nexport type CalAccountResetDto = CalSubstructureDto & {\n  account_index?: number;\n  require_pre_balance_zero?: boolean;\n  value_kind?: string;\n  token?: CalTokenValueDto;\n  require_native_pre_balance_zero?: boolean;\n};\n\nexport type CalSlotConstraintDto = {\n  signer: string;\n  writable: string;\n};\n\nexport type CalAccountSchemaDto = {\n  count_min?: number;\n  count_max?: number;\n  remaining_policy?: CalSlotConstraintDto;\n  slots?: CalSlotConstraintDto[];\n};\n\nexport type CalDisplayFieldDto = CalSubstructureDto & {\n  name?: string;\n  param?: { type: string; value?: CalValueDto; token?: CalValueDto };\n};\n\nexport type CalInstructionDescriptorDto = {\n  discriminator_hex?: string;\n  instruction_name?: string;\n  descriptor: CalSignedDescriptorDto;\n  idl_descriptor?: {\n    type_pool?: CalTypePoolEntryDto[];\n    root_type?: number;\n  };\n  mint_association?: CalMintAssociationDto;\n  owner_association?: CalOwnerAssociationDto;\n  enum_variants?: Record<string, Record<string, CalEnumVariantDto>>;\n  display_fields?: CalDisplayFieldDto[];\n  value_flow_ports?: CalValueFlowPortDto[];\n  hide_rules?: CalHideRuleDto[];\n  account_resets?: CalAccountResetDto[];\n  /** Absent means \"no ACCOUNT_SCHEMA check\". */\n  account_schema?: CalAccountSchemaDto;\n  /**\n   * Host-side routing tags, outside the signed `descriptor`. Not covered by\n   * the program codec: the mapper validates it on its own with\n   * {@link calSigningRouteCodec} so a malformed value only drops the tags.\n   */\n  signing_route?: CalSigningRouteDto;\n};\n\n/** `role` is `\"required\"` or `\"allowed\"`; the mapper drops any other value. */\nexport type CalSigningRouteEntryDto = {\n  rule: string;\n  role: string;\n};\n\nexport type CalSigningRouteDto = {\n  basic_flow?: CalSigningRouteEntryDto[];\n};\n\n// One program object of the `solana_programs` response: the program `id`, its\n// `chain_id`, and the flat `instructions` array (keyed downstream by\n// `discriminator_hex`).\nexport type CalInstructionProgramDto = {\n  id: string;\n  chain_id: number;\n  instructions: CalInstructionDescriptorDto[];\n};\n\n// Outer shape: array of program objects (one per requested `id`).\nexport type CalInstructionInfoResponseDto = CalInstructionProgramDto[];\n\n// --- Validation codecs (runtime). Validate only the fields the loaders read;\n// `Codec.interface` ignores unknown extras so CAL can add fields freely. ---\n\nconst calSignaturesCodec = Codec.interface({\n  prod: optional(string),\n  test: optional(string),\n});\n\nconst calSignedDescriptorCodec = Codec.interface({\n  data: string,\n  signatures: calSignaturesCodec,\n});\n\nconst calEnumVariantCodec = Codec.interface({\n  descriptor: calSignedDescriptorCodec,\n});\n\nconst calSubstructureCodec = Codec.interface({\n  descriptor: string,\n});\n\nconst calSlotConstraintCodec = Codec.interface({\n  signer: string,\n  writable: string,\n});\n\nconst calAccountSchemaCodec = Codec.interface({\n  count_min: optional(number),\n  count_max: optional(number),\n  remaining_policy: optional(calSlotConstraintCodec),\n  slots: optional(array(calSlotConstraintCodec)),\n});\n\nconst calInstructionDescriptorCodec = Codec.interface({\n  discriminator_hex: optional(string),\n  descriptor: calSignedDescriptorCodec,\n  enum_variants: optional(record(string, record(string, calEnumVariantCodec))),\n  display_fields: optional(array(calSubstructureCodec)),\n  value_flow_ports: optional(array(calSubstructureCodec)),\n  hide_rules: optional(array(calSubstructureCodec)),\n  account_resets: optional(array(calSubstructureCodec)),\n  account_schema: optional(calAccountSchemaCodec),\n});\n\n/**\n * Codec for one instruction's `signing_route`. Kept out of\n * `calInstructionDescriptorCodec` on purpose: routing tags are optional\n * metadata, and a malformed value must not invalidate the program's\n * clear-signing descriptors.\n */\nexport const calSigningRouteCodec = Codec.interface({\n  basic_flow: optional(\n    array(\n      Codec.interface({\n        rule: string,\n        role: string,\n      }),\n    ),\n  ),\n});\n\n/**\n * Codec for one program object of the `solana_programs` response. Used by the\n * datasource to validate the CAL payload before handing it to the loaders.\n * Only loader-consumed fields are validated; unrelated CAL fields\n * (`idl_descriptor`, `mint_association`, \u2026) are ignored.\n */\nexport const calInstructionProgramCodec = Codec.interface({\n  id: string,\n  chain_id: number,\n  instructions: array(calInstructionDescriptorCodec),\n});\n"],
+  "mappings": "AAQA,OAAS,SAAAA,EAAO,SAAAC,EAAO,UAAAC,EAAQ,YAAAC,EAAU,UAAAC,EAAQ,UAAAC,MAAc,YAgK/D,MAAMC,EAAqBL,EAAM,UAAU,CACzC,KAAME,EAASE,CAAM,EACrB,KAAMF,EAASE,CAAM,CACvB,CAAC,EAEKE,EAA2BN,EAAM,UAAU,CAC/C,KAAMI,EACN,WAAYC,CACd,CAAC,EAEKE,EAAsBP,EAAM,UAAU,CAC1C,WAAYM,CACd,CAAC,EAEKE,EAAuBR,EAAM,UAAU,CAC3C,WAAYI,CACd,CAAC,EAEKK,EAAyBT,EAAM,UAAU,CAC7C,OAAQI,EACR,SAAUA,CACZ,CAAC,EAEKM,EAAwBV,EAAM,UAAU,CAC5C,UAAWE,EAASD,CAAM,EAC1B,UAAWC,EAASD,CAAM,EAC1B,iBAAkBC,EAASO,CAAsB,EACjD,MAAOP,EAASH,EAAMU,CAAsB,CAAC,CAC/C,CAAC,EAEKE,EAAgCX,EAAM,UAAU,CACpD,kBAAmBE,EAASE,CAAM,EAClC,WAAYE,EACZ,cAAeJ,EAASC,EAAOC,EAAQD,EAAOC,EAAQG,CAAmB,CAAC,CAAC,EAC3E,eAAgBL,EAASH,EAAMS,CAAoB,CAAC,EACpD,iBAAkBN,EAASH,EAAMS,CAAoB,CAAC,EACtD,WAAYN,EAASH,EAAMS,CAAoB,CAAC,EAChD,eAAgBN,EAASH,EAAMS,CAAoB,CAAC,EACpD,eAAgBN,EAASQ,CAAqB,CAChD,CAAC,EAQYE,EAAuBZ,EAAM,UAAU,CAClD,WAAYE,EACVH,EACEC,EAAM,UAAU,CACd,KAAMI,EACN,KAAMA,CACR,CAAC,CACH,CACF,CACF,CAAC,EAQYS,EAA6Bb,EAAM,UAAU,CACxD,GAAII,EACJ,SAAUH,EACV,aAAcF,EAAMY,CAA6B,CACnD,CAAC",
+  "names": ["array", "Codec", "number", "optional", "record", "string", "calSignaturesCodec", "calSignedDescriptorCodec", "calEnumVariantCodec", "calSubstructureCodec", "calSlotConstraintCodec", "calAccountSchemaCodec", "calInstructionDescriptorCodec", "calSigningRouteCodec", "calInstructionProgramCodec"]
 }

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoMapper.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{Left as d,Right as C}from"purify-ts";import{SolanaInstructionSubstructureKind as i}from"../../../../modules/solana/model/SolanaPayloads";import{u16Codec as S}from"../../../../shared/utils/uIntCodec";function l(n,t){return n[t]}function f(n=[]){return n.map(t=>({account_indices:t.account_indices,optional_account_strategy:t.optional_account_strategy,token_value:t.token_value,active_when:t.active_when}))}function m(n=[]){return n.flatMap(t=>t.account_index===void 0?[]:[{account_index:t.account_index,require_pre_balance_zero:t.require_pre_balance_zero,value_kind:t.value_kind,token:t.token,require_native_pre_balance_zero:t.require_native_pre_balance_zero}])}function y(n=[]){return n.map(t=>({rule_set_index:t.rule_set_index,target:t.target,condition:t.condition}))}function D(n){return n===void 0?[]:n.account_index===void 0||n.owner===void 0?[]:[{account_index:n.account_index,owner:n.owner}]}const c=new Set(["FORBIDDEN","EITHER","REQUIRED"]);function u(n){const t=c.has(n.signer)?n.signer:"EITHER",a=c.has(n.writable)?n.writable:"EITHER";return{signer:t,writable:a}}function I(n){if(n!==void 0)return{count_min:n.count_min??0,count_max:n.count_max??255,remaining_policy:n.remaining_policy?u(n.remaining_policy):{signer:"EITHER",writable:"EITHER"},slots:(n.slots??[]).map(u)}}function E(n=[]){return n.map(t=>({name:t.name,param:t.param??{type:""}}))}function w(n){return[...(n.display_fields??[]).map(t=>({kind:i.DISPLAY_FIELD,data:t.descriptor})),...(n.value_flow_ports??[]).map(t=>({kind:i.VALUE_FLOW_PORT,data:t.descriptor})),...(n.hide_rules??[]).map(t=>({kind:i.HIDE_RULE,data:t.descriptor})),...(n.account_resets??[]).map(t=>({kind:i.ACCOUNT_RESET,data:t.descriptor}))]}function p(n,t){const a=[];for(const[e,o]of Object.entries(n.enum_variants??{}))for(const[_,r]of Object.entries(o)){const s=Number(_);S.decode(s).isLeft()||a.push({enumId:e,variantIndex:s,descriptor:{data:r.descriptor.data,signature:l(r.descriptor.signatures,t)??""}})}return a}function A(n,t){return Object.values(n).flatMap(a=>p(a,t))}function b(n,t,a,e){const o=l(a.descriptor.signatures,e);return o?C({programId:n,discriminator:t,instructionName:a.instruction_name,instructionInfo:{data:a.descriptor.data,signature:o},substructures:w(a),enumVariants:p(a,e),idlDescriptor:{typePool:a.idl_descriptor?.type_pool??[],rootType:a.idl_descriptor?.root_type??0},mintAssociations:a.mint_association?[a.mint_association]:[],ownerAssociations:D(a.owner_association),valueFlowPorts:f(a.value_flow_ports),accountResets:m(a.account_resets),displayFields:E(a.display_fields),hideRules:y(a.hide_rules),accountSchema:I(a.account_schema)}):d(new Error(`[ContextModule] InstructionInfoDataSource: missing '${e}' signature for (${n}, ${t})`))}export{m as toAccountResets,I as toAccountSchema,E as toDisplayFields,y as toHideRules,b as toInstructionInfoPayload,D as toOwnerAssociations,A as toProgramEnumVariants,f as toValueFlowPorts};
+import{Left as d,Right as f}from"purify-ts";import{SolanaInstructionSubstructureKind as r}from"../../../../modules/solana/model/SolanaPayloads";import{u16Codec as C}from"../../../../shared/utils/uIntCodec";import{calSigningRouteCodec as S}from"./InstructionInfoDto";function p(n,t){return n[t]}function m(n=[]){return n.map(t=>({account_indices:t.account_indices,optional_account_strategy:t.optional_account_strategy,token_value:t.token_value,active_when:t.active_when}))}function y(n=[]){return n.flatMap(t=>t.account_index===void 0?[]:[{account_index:t.account_index,require_pre_balance_zero:t.require_pre_balance_zero,value_kind:t.value_kind,token:t.token,require_native_pre_balance_zero:t.require_native_pre_balance_zero}])}function D(n=[]){return n.map(t=>({rule_set_index:t.rule_set_index,target:t.target,condition:t.condition}))}function g(n){return n===void 0?[]:n.account_index===void 0||n.owner===void 0?[]:[{account_index:n.account_index,owner:n.owner}]}const u=new Set(["FORBIDDEN","EITHER","REQUIRED"]);function l(n){const t=u.has(n.signer)?n.signer:"EITHER",a=u.has(n.writable)?n.writable:"EITHER";return{signer:t,writable:a}}function I(n){if(n!==void 0)return{count_min:n.count_min??0,count_max:n.count_max??255,remaining_policy:n.remaining_policy?l(n.remaining_policy):{signer:"EITHER",writable:"EITHER"},slots:(n.slots??[]).map(l)}}function w(n=[]){return n.map(t=>({name:t.name,param:t.param??{type:""}}))}function E(n){return[...(n.display_fields??[]).map(t=>({kind:r.DISPLAY_FIELD,data:t.descriptor})),...(n.value_flow_ports??[]).map(t=>({kind:r.VALUE_FLOW_PORT,data:t.descriptor})),...(n.hide_rules??[]).map(t=>({kind:r.HIDE_RULE,data:t.descriptor})),...(n.account_resets??[]).map(t=>({kind:r.ACCOUNT_RESET,data:t.descriptor}))]}function _(n,t){const a=[];for(const[e,o]of Object.entries(n.enum_variants??{}))for(const[i,s]of Object.entries(o)){const c=Number(i);C.decode(c).isLeft()||a.push({enumId:e,variantIndex:c,descriptor:{data:s.descriptor.data,signature:p(s.descriptor.signatures,t)??""}})}return a}function b(n,t){return Object.values(n).flatMap(a=>_(a,t))}function F(n){return Object.entries(n).flatMap(([t,a])=>t===""||a.signing_route===void 0?[]:S.decode(a.signing_route).caseOf({Left:()=>[],Right:({basic_flow:e=[]})=>e.flatMap(({rule:o,role:i})=>o.length>0&&(i==="required"||i==="allowed")?[{discriminator:t,rule:o,role:i}]:[])}))}function v(n,t,a,e){const o=p(a.descriptor.signatures,e);return o?f({programId:n,discriminator:t,instructionName:a.instruction_name,instructionInfo:{data:a.descriptor.data,signature:o},substructures:E(a),enumVariants:_(a,e),idlDescriptor:{typePool:a.idl_descriptor?.type_pool??[],rootType:a.idl_descriptor?.root_type??0},mintAssociations:a.mint_association?[a.mint_association]:[],ownerAssociations:g(a.owner_association),valueFlowPorts:m(a.value_flow_ports),accountResets:y(a.account_resets),displayFields:w(a.display_fields),hideRules:D(a.hide_rules),accountSchema:I(a.account_schema)}):d(new Error(`[ContextModule] InstructionInfoDataSource: missing '${e}' signature for (${n}, ${t})`))}export{y as toAccountResets,I as toAccountSchema,F as toBasicFlowTags,w as toDisplayFields,D as toHideRules,v as toInstructionInfoPayload,g as toOwnerAssociations,b as toProgramEnumVariants,m as toValueFlowPorts};
 //# sourceMappingURL=InstructionInfoMapper.js.map

package/lib/esm/src/modules/solana/instruction-info/data/InstructionInfoMapper.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/data/InstructionInfoMapper.ts"],
-  "sourcesContent": ["// Maps the validated CAL instruction-descriptor DTOs into the core\n// `SolanaInstructionInfoPayload` model. Keeping this in the data layer means\n// the domain `InstructionInfoContextLoader` never has to know the CAL DTO\n// shapes \u2014 it consumes core models only.\n\nimport { type Either, Left, Right } from \"purify-ts\";\n\nimport {\n  type SolanaCalAccountReset,\n  type SolanaCalAccountSchema,\n  type SolanaCalDisplayField,\n  type SolanaCalHideRule,\n  type SolanaCalOwnerAssociation,\n  type SolanaCalSlotConstraint,\n  type SolanaCalValueFlowPort,\n  type SolanaInstructionEnumVariant,\n  type SolanaInstructionInfoPayload,\n  type SolanaInstructionSubstructure,\n  SolanaInstructionSubstructureKind,\n} from \"@/modules/solana/model/SolanaPayloads\";\nimport { u16Codec } from \"@/shared/utils/uIntCodec\";\n\nimport {\n  type CalAccountResetDto,\n  type CalAccountSchemaDto,\n  type CalDisplayFieldDto,\n  type CalHideRuleDto,\n  type CalInstructionDescriptorDto,\n  type CalOwnerAssociationDto,\n  type CalSignatures,\n  type CalSlotConstraintDto,\n  type CalValueFlowPortDto,\n} from \"./InstructionInfoDto\";\n\nexport type CalMode = \"prod\" | \"test\";\n\nfunction pickSignature(\n  signatures: CalSignatures,\n  mode: CalMode,\n): string | undefined {\n  return signatures[mode];\n}\n\n// --- DTO \u2192 decoded-payload projections. Pick only the fields the host-side\n// requirement builder reads, dropping the signed-TLV `descriptor` carried by\n// the DTO. ---\n\nexport function toValueFlowPorts(\n  dtos: CalValueFlowPortDto[] = [],\n): SolanaCalValueFlowPort[] {\n  return dtos.map((port) => ({\n    account_indices: port.account_indices,\n    optional_account_strategy: port.optional_account_strategy,\n    token_value: port.token_value,\n    active_when: port.active_when,\n  }));\n}\n\nexport function toAccountResets(\n  dtos: CalAccountResetDto[] = [],\n): SolanaCalAccountReset[] {\n  // Drop malformed resets (missing account_index) rather than defaulting to\n  // slot 0, which would create an unintended TOKEN_ACCOUNT_STATE requirement.\n  return dtos.flatMap((reset) =>\n    reset.account_index === undefined\n      ? []\n      : [\n          {\n            account_index: reset.account_index,\n            require_pre_balance_zero: reset.require_pre_balance_zero,\n            value_kind: reset.value_kind,\n            token: reset.token,\n            require_native_pre_balance_zero:\n              reset.require_native_pre_balance_zero,\n          },\n        ],\n  );\n}\n\n/**\n * Every rule is carried, including one CAL served without a `condition`. The\n * rule's signed TLV goes to the device through {@link toSubstructures}\n * regardless, and the device resolves the `target` of every rule it receives \u2014\n * so dropping the entry here would cost the host the `ALT_RESOLUTION` for that\n * target and make the device refuse to sign. A missing condition only means no\n * requirement keys off this rule's predicate.\n */\nexport function toHideRules(dtos: CalHideRuleDto[] = []): SolanaCalHideRule[] {\n  return dtos.map((rule) => ({\n    rule_set_index: rule.rule_set_index,\n    target: rule.target,\n    condition: rule.condition,\n  }));\n}\n\n/**\n * CAL carries at most one `owner_association` per descriptor; the payload holds\n * a list so the transaction-wide owner map is built the same way as the mint\n * map. Both halves of the pair are required (spec: \"must both be present or\n * both absent\"), so a half-declared association is dropped.\n */\nexport function toOwnerAssociations(\n  dto: CalOwnerAssociationDto | undefined,\n): SolanaCalOwnerAssociation[] {\n  if (dto === undefined) return [];\n  if (dto.account_index === undefined || dto.owner === undefined) return [];\n  return [{ account_index: dto.account_index, owner: dto.owner }];\n}\n\nconst VALID_CONSTRAINT_VALUES = new Set([\"FORBIDDEN\", \"EITHER\", \"REQUIRED\"]);\n\n/**\n * Unlike `value_kind` on `ACCOUNT_RESET` (an unknown value is a decode\n * error), an unknown/missing `signer` or `writable` here deliberately fails\n * open to `\"EITHER\"` \u2014 i.e. that slot is left unchecked rather than the whole\n * descriptor rejected. ACCOUNT_SCHEMA is only a host-side optimization (the\n * device is the authority at FINALIZE), so the worst outcome of a malformed\n * value is a missed early exit, not an incorrect signature.\n */\nfunction toSlotConstraint(dto: CalSlotConstraintDto): SolanaCalSlotConstraint {\n  const signer = VALID_CONSTRAINT_VALUES.has(dto.signer)\n    ? (dto.signer as SolanaCalSlotConstraint[\"signer\"])\n    : \"EITHER\";\n  const writable = VALID_CONSTRAINT_VALUES.has(dto.writable)\n    ? (dto.writable as SolanaCalSlotConstraint[\"writable\"])\n    : \"EITHER\";\n  return { signer, writable };\n}\n\nexport function toAccountSchema(\n  dto: CalAccountSchemaDto | undefined,\n): SolanaCalAccountSchema | undefined {\n  if (dto === undefined) return undefined;\n  return {\n    count_min: dto.count_min ?? 0,\n    count_max: dto.count_max ?? 255,\n    remaining_policy: dto.remaining_policy\n      ? toSlotConstraint(dto.remaining_policy)\n      : { signer: \"EITHER\", writable: \"EITHER\" },\n    slots: (dto.slots ?? []).map(toSlotConstraint),\n  };\n}\n\nexport function toDisplayFields(\n  dtos: CalDisplayFieldDto[] = [],\n): SolanaCalDisplayField[] {\n  return dtos.map((field) => ({\n    name: field.name,\n    param: field.param ?? { type: \"\" },\n  }));\n}\n\nfunction toSubstructures(\n  dto: CalInstructionDescriptorDto,\n): SolanaInstructionSubstructure[] {\n  return [\n    ...(dto.display_fields ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.DISPLAY_FIELD,\n      data: s.descriptor,\n    })),\n    ...(dto.value_flow_ports ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.VALUE_FLOW_PORT,\n      data: s.descriptor,\n    })),\n    ...(dto.hide_rules ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.HIDE_RULE,\n      data: s.descriptor,\n    })),\n    ...(dto.account_resets ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.ACCOUNT_RESET,\n      data: s.descriptor,\n    })),\n  ];\n}\n\n/**\n * Flatten the CAL-bundled enum variants (keyed enumId \u2192 variantIndex). Keys\n * that don't validate as a u16 are skipped rather than leaking NaN/out-of-range\n * indices into the payload.\n */\nfunction toEnumVariants(\n  dto: CalInstructionDescriptorDto,\n  mode: CalMode,\n): SolanaInstructionEnumVariant[] {\n  const enumVariants: SolanaInstructionEnumVariant[] = [];\n  for (const [enumId, variants] of Object.entries(dto.enum_variants ?? {})) {\n    for (const [variantIndex, variant] of Object.entries(variants)) {\n      const index = Number(variantIndex);\n      if (u16Codec.decode(index).isLeft()) {\n        continue;\n      }\n      enumVariants.push({\n        enumId,\n        variantIndex: index,\n        descriptor: {\n          data: variant.descriptor.data,\n          signature: pickSignature(variant.descriptor.signatures, mode) ?? \"\",\n        },\n      });\n    }\n  }\n  return enumVariants;\n}\n\n/**\n * Flatten the enum variants of every descriptor in a program into a single\n * list. CAL nests `enum_variants` inside each instruction descriptor but\n * guarantees `(enumId, variantIndex)` is unique across a program, so the enum\n * loader resolves a selection against this program-level list \u2014 independently\n * of whether any individual instruction descriptor carried a usable signature.\n */\nexport function toProgramEnumVariants(\n  descriptors: Record<string, CalInstructionDescriptorDto>,\n  mode: CalMode,\n): SolanaInstructionEnumVariant[] {\n  return Object.values(descriptors).flatMap((dto) => toEnumVariants(dto, mode));\n}\n\n/**\n * Transform one validated CAL descriptor DTO into the core\n * {@link SolanaInstructionInfoPayload}. Returns a `Left` when the descriptor is\n * unusable (no signature for the configured `mode`), so the caller can surface\n * a per-descriptor ERROR rather than emitting an empty signature.\n *\n * `programId` comes from the enclosing `solana_programs` envelope `id`;\n * `discriminator` from the instruction's `discriminator_hex`.\n */\nexport function toInstructionInfoPayload(\n  programId: string,\n  discriminator: string,\n  dto: CalInstructionDescriptorDto,\n  mode: CalMode,\n): Either<Error, SolanaInstructionInfoPayload> {\n  const signature = pickSignature(dto.descriptor.signatures, mode);\n  if (!signature) {\n    return Left(\n      new Error(\n        `[ContextModule] InstructionInfoDataSource: missing '${mode}' signature for (${programId}, ${discriminator})`,\n      ),\n    );\n  }\n\n  return Right({\n    programId,\n    discriminator,\n    instructionName: dto.instruction_name,\n    instructionInfo: {\n      data: dto.descriptor.data,\n      signature,\n    },\n    substructures: toSubstructures(dto),\n    enumVariants: toEnumVariants(dto, mode),\n    idlDescriptor: {\n      typePool: dto.idl_descriptor?.type_pool ?? [],\n      rootType: dto.idl_descriptor?.root_type ?? 0,\n    },\n    mintAssociations: dto.mint_association ? [dto.mint_association] : [],\n    ownerAssociations: toOwnerAssociations(dto.owner_association),\n    valueFlowPorts: toValueFlowPorts(dto.value_flow_ports),\n    accountResets: toAccountResets(dto.account_resets),\n    displayFields: toDisplayFields(dto.display_fields),\n    hideRules: toHideRules(dto.hide_rules),\n    accountSchema: toAccountSchema(dto.account_schema),\n  });\n}\n"],
-  "mappings": "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",
-  "names": ["Left", "Right", "SolanaInstructionSubstructureKind", "u16Codec", "pickSignature", "signatures", "mode", "toValueFlowPorts", "dtos", "port", "toAccountResets", "reset", "toHideRules", "rule", "toOwnerAssociations", "dto", "VALID_CONSTRAINT_VALUES", "toSlotConstraint", "signer", "writable", "toAccountSchema", "toDisplayFields", "field", "toSubstructures", "s", "toEnumVariants", "enumVariants", "enumId", "variants", "variantIndex", "variant", "index", "toProgramEnumVariants", "descriptors", "toInstructionInfoPayload", "programId", "discriminator", "signature"]
+  "sourcesContent": ["// Maps the validated CAL instruction-descriptor DTOs into the core\n// `SolanaInstructionInfoPayload` model. Keeping this in the data layer means\n// the domain `InstructionInfoContextLoader` never has to know the CAL DTO\n// shapes \u2014 it consumes core models only.\n\nimport { type Either, Left, Right } from \"purify-ts\";\n\nimport {\n  type SolanaCalAccountReset,\n  type SolanaCalAccountSchema,\n  type SolanaCalDisplayField,\n  type SolanaCalHideRule,\n  type SolanaCalOwnerAssociation,\n  type SolanaCalSlotConstraint,\n  type SolanaCalValueFlowPort,\n  type SolanaInstructionEnumVariant,\n  type SolanaInstructionInfoPayload,\n  type SolanaInstructionSubstructure,\n  SolanaInstructionSubstructureKind,\n} from \"@/modules/solana/model/SolanaPayloads\";\nimport { u16Codec } from \"@/shared/utils/uIntCodec\";\n\nimport { type SolanaBasicFlowTag } from \"./InstructionInfoDataSource\";\nimport {\n  type CalAccountResetDto,\n  type CalAccountSchemaDto,\n  type CalDisplayFieldDto,\n  type CalHideRuleDto,\n  type CalInstructionDescriptorDto,\n  type CalOwnerAssociationDto,\n  type CalSignatures,\n  calSigningRouteCodec,\n  type CalSlotConstraintDto,\n  type CalValueFlowPortDto,\n} from \"./InstructionInfoDto\";\n\nexport type CalMode = \"prod\" | \"test\";\n\nfunction pickSignature(\n  signatures: CalSignatures,\n  mode: CalMode,\n): string | undefined {\n  return signatures[mode];\n}\n\n// --- DTO \u2192 decoded-payload projections. Pick only the fields the host-side\n// requirement builder reads, dropping the signed-TLV `descriptor` carried by\n// the DTO. ---\n\nexport function toValueFlowPorts(\n  dtos: CalValueFlowPortDto[] = [],\n): SolanaCalValueFlowPort[] {\n  return dtos.map((port) => ({\n    account_indices: port.account_indices,\n    optional_account_strategy: port.optional_account_strategy,\n    token_value: port.token_value,\n    active_when: port.active_when,\n  }));\n}\n\nexport function toAccountResets(\n  dtos: CalAccountResetDto[] = [],\n): SolanaCalAccountReset[] {\n  // Drop malformed resets (missing account_index) rather than defaulting to\n  // slot 0, which would create an unintended TOKEN_ACCOUNT_STATE requirement.\n  return dtos.flatMap((reset) =>\n    reset.account_index === undefined\n      ? []\n      : [\n          {\n            account_index: reset.account_index,\n            require_pre_balance_zero: reset.require_pre_balance_zero,\n            value_kind: reset.value_kind,\n            token: reset.token,\n            require_native_pre_balance_zero:\n              reset.require_native_pre_balance_zero,\n          },\n        ],\n  );\n}\n\n/**\n * Every rule is carried, including one CAL served without a `condition`. The\n * rule's signed TLV goes to the device through {@link toSubstructures}\n * regardless, and the device resolves the `target` of every rule it receives \u2014\n * so dropping the entry here would cost the host the `ALT_RESOLUTION` for that\n * target and make the device refuse to sign. A missing condition only means no\n * requirement keys off this rule's predicate.\n */\nexport function toHideRules(dtos: CalHideRuleDto[] = []): SolanaCalHideRule[] {\n  return dtos.map((rule) => ({\n    rule_set_index: rule.rule_set_index,\n    target: rule.target,\n    condition: rule.condition,\n  }));\n}\n\n/**\n * CAL carries at most one `owner_association` per descriptor; the payload holds\n * a list so the transaction-wide owner map is built the same way as the mint\n * map. Both halves of the pair are required (spec: \"must both be present or\n * both absent\"), so a half-declared association is dropped.\n */\nexport function toOwnerAssociations(\n  dto: CalOwnerAssociationDto | undefined,\n): SolanaCalOwnerAssociation[] {\n  if (dto === undefined) return [];\n  if (dto.account_index === undefined || dto.owner === undefined) return [];\n  return [{ account_index: dto.account_index, owner: dto.owner }];\n}\n\nconst VALID_CONSTRAINT_VALUES = new Set([\"FORBIDDEN\", \"EITHER\", \"REQUIRED\"]);\n\n/**\n * Unlike `value_kind` on `ACCOUNT_RESET` (an unknown value is a decode\n * error), an unknown/missing `signer` or `writable` here deliberately fails\n * open to `\"EITHER\"` \u2014 i.e. that slot is left unchecked rather than the whole\n * descriptor rejected. ACCOUNT_SCHEMA is only a host-side optimization (the\n * device is the authority at FINALIZE), so the worst outcome of a malformed\n * value is a missed early exit, not an incorrect signature.\n */\nfunction toSlotConstraint(dto: CalSlotConstraintDto): SolanaCalSlotConstraint {\n  const signer = VALID_CONSTRAINT_VALUES.has(dto.signer)\n    ? (dto.signer as SolanaCalSlotConstraint[\"signer\"])\n    : \"EITHER\";\n  const writable = VALID_CONSTRAINT_VALUES.has(dto.writable)\n    ? (dto.writable as SolanaCalSlotConstraint[\"writable\"])\n    : \"EITHER\";\n  return { signer, writable };\n}\n\nexport function toAccountSchema(\n  dto: CalAccountSchemaDto | undefined,\n): SolanaCalAccountSchema | undefined {\n  if (dto === undefined) return undefined;\n  return {\n    count_min: dto.count_min ?? 0,\n    count_max: dto.count_max ?? 255,\n    remaining_policy: dto.remaining_policy\n      ? toSlotConstraint(dto.remaining_policy)\n      : { signer: \"EITHER\", writable: \"EITHER\" },\n    slots: (dto.slots ?? []).map(toSlotConstraint),\n  };\n}\n\nexport function toDisplayFields(\n  dtos: CalDisplayFieldDto[] = [],\n): SolanaCalDisplayField[] {\n  return dtos.map((field) => ({\n    name: field.name,\n    param: field.param ?? { type: \"\" },\n  }));\n}\n\nfunction toSubstructures(\n  dto: CalInstructionDescriptorDto,\n): SolanaInstructionSubstructure[] {\n  return [\n    ...(dto.display_fields ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.DISPLAY_FIELD,\n      data: s.descriptor,\n    })),\n    ...(dto.value_flow_ports ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.VALUE_FLOW_PORT,\n      data: s.descriptor,\n    })),\n    ...(dto.hide_rules ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.HIDE_RULE,\n      data: s.descriptor,\n    })),\n    ...(dto.account_resets ?? []).map((s) => ({\n      kind: SolanaInstructionSubstructureKind.ACCOUNT_RESET,\n      data: s.descriptor,\n    })),\n  ];\n}\n\n/**\n * Flatten the CAL-bundled enum variants (keyed enumId \u2192 variantIndex). Keys\n * that don't validate as a u16 are skipped rather than leaking NaN/out-of-range\n * indices into the payload.\n */\nfunction toEnumVariants(\n  dto: CalInstructionDescriptorDto,\n  mode: CalMode,\n): SolanaInstructionEnumVariant[] {\n  const enumVariants: SolanaInstructionEnumVariant[] = [];\n  for (const [enumId, variants] of Object.entries(dto.enum_variants ?? {})) {\n    for (const [variantIndex, variant] of Object.entries(variants)) {\n      const index = Number(variantIndex);\n      if (u16Codec.decode(index).isLeft()) {\n        continue;\n      }\n      enumVariants.push({\n        enumId,\n        variantIndex: index,\n        descriptor: {\n          data: variant.descriptor.data,\n          signature: pickSignature(variant.descriptor.signatures, mode) ?? \"\",\n        },\n      });\n    }\n  }\n  return enumVariants;\n}\n\n/**\n * Flatten the enum variants of every descriptor in a program into a single\n * list. CAL nests `enum_variants` inside each instruction descriptor but\n * guarantees `(enumId, variantIndex)` is unique across a program, so the enum\n * loader resolves a selection against this program-level list \u2014 independently\n * of whether any individual instruction descriptor carried a usable signature.\n */\nexport function toProgramEnumVariants(\n  descriptors: Record<string, CalInstructionDescriptorDto>,\n  mode: CalMode,\n): SolanaInstructionEnumVariant[] {\n  return Object.values(descriptors).flatMap((dto) => toEnumVariants(dto, mode));\n}\n\n/**\n * Collect the `signing_route.basic_flow` tags of every descriptor in a\n * program. `signing_route` is validated here rather than by the program codec,\n * so a malformed value drops that instruction's tags without touching its\n * descriptor. Unknown roles are dropped, and so are tags on an instruction\n * without a discriminator (keyed under `\"\"`): CAL rules are instruction-level.\n */\nexport function toBasicFlowTags(\n  descriptors: Record<string, CalInstructionDescriptorDto>,\n): SolanaBasicFlowTag[] {\n  return Object.entries(descriptors).flatMap(([discriminator, dto]) => {\n    if (discriminator === \"\" || dto.signing_route === undefined) return [];\n    return calSigningRouteCodec\n      .decode(dto.signing_route)\n      .caseOf<SolanaBasicFlowTag[]>({\n        Left: () => [],\n        Right: ({ basic_flow = [] }) =>\n          basic_flow.flatMap(({ rule, role }) =>\n            rule.length > 0 && (role === \"required\" || role === \"allowed\")\n              ? [{ discriminator, rule, role }]\n              : [],\n          ),\n      });\n  });\n}\n\n/**\n * Transform one validated CAL descriptor DTO into the core\n * {@link SolanaInstructionInfoPayload}. Returns a `Left` when the descriptor is\n * unusable (no signature for the configured `mode`), so the caller can surface\n * a per-descriptor ERROR rather than emitting an empty signature.\n *\n * `programId` comes from the enclosing `solana_programs` envelope `id`;\n * `discriminator` from the instruction's `discriminator_hex`.\n */\nexport function toInstructionInfoPayload(\n  programId: string,\n  discriminator: string,\n  dto: CalInstructionDescriptorDto,\n  mode: CalMode,\n): Either<Error, SolanaInstructionInfoPayload> {\n  const signature = pickSignature(dto.descriptor.signatures, mode);\n  if (!signature) {\n    return Left(\n      new Error(\n        `[ContextModule] InstructionInfoDataSource: missing '${mode}' signature for (${programId}, ${discriminator})`,\n      ),\n    );\n  }\n\n  return Right({\n    programId,\n    discriminator,\n    instructionName: dto.instruction_name,\n    instructionInfo: {\n      data: dto.descriptor.data,\n      signature,\n    },\n    substructures: toSubstructures(dto),\n    enumVariants: toEnumVariants(dto, mode),\n    idlDescriptor: {\n      typePool: dto.idl_descriptor?.type_pool ?? [],\n      rootType: dto.idl_descriptor?.root_type ?? 0,\n    },\n    mintAssociations: dto.mint_association ? [dto.mint_association] : [],\n    ownerAssociations: toOwnerAssociations(dto.owner_association),\n    valueFlowPorts: toValueFlowPorts(dto.value_flow_ports),\n    accountResets: toAccountResets(dto.account_resets),\n    displayFields: toDisplayFields(dto.display_fields),\n    hideRules: toHideRules(dto.hide_rules),\n    accountSchema: toAccountSchema(dto.account_schema),\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["Left", "Right", "SolanaInstructionSubstructureKind", "u16Codec", "calSigningRouteCodec", "pickSignature", "signatures", "mode", "toValueFlowPorts", "dtos", "port", "toAccountResets", "reset", "toHideRules", "rule", "toOwnerAssociations", "dto", "VALID_CONSTRAINT_VALUES", "toSlotConstraint", "signer", "writable", "toAccountSchema", "toDisplayFields", "field", "toSubstructures", "s", "toEnumVariants", "enumVariants", "enumId", "variants", "variantIndex", "variant", "index", "toProgramEnumVariants", "descriptors", "toBasicFlowTags", "discriminator", "basic_flow", "role", "toInstructionInfoPayload", "programId", "signature"]
 }

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoModuleFactory.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{ContainerModule as n}from"inversify";import{HttpInstructionInfoDataSource as r}from"../../../../modules/solana/instruction-info/data/HttpInstructionInfoDataSource";import{instructionInfoTypes as t}from"../../../../modules/solana/instruction-info/di/instructionInfoTypes";import{InstructionInfoContextLoader as e}from"../../../../modules/solana/instruction-info/domain/InstructionInfoContextLoader";const I=()=>new n(({bind:o})=>{o(t.InstructionInfoDataSource).to(r),o(t.InstructionInfoContextLoader).to(e)});export{I as instructionInfoModuleFactory};
+import{ContainerModule as n}from"inversify";import{HttpInstructionInfoDataSource as r}from"../../../../modules/solana/instruction-info/data/HttpInstructionInfoDataSource";import{instructionInfoTypes as t}from"../../../../modules/solana/instruction-info/di/instructionInfoTypes";import{InstructionInfoContextLoader as e}from"../../../../modules/solana/instruction-info/domain/InstructionInfoContextLoader";import{SolanaBasicFlowRuleContextLoader as a}from"../../../../modules/solana/instruction-info/domain/SolanaBasicFlowRuleContextLoader";const s=()=>new n(({bind:o})=>{o(t.InstructionInfoDataSource).to(r).inSingletonScope(),o(t.InstructionInfoContextLoader).to(e),o(t.SolanaBasicFlowRuleContextLoader).to(a)});export{s as instructionInfoModuleFactory};
 //# sourceMappingURL=instructionInfoModuleFactory.js.map

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoModuleFactory.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/di/instructionInfoModuleFactory.ts"],
-  "sourcesContent": ["import { ContainerModule } from \"inversify\";\n\nimport { HttpInstructionInfoDataSource } from \"@/modules/solana/instruction-info/data/HttpInstructionInfoDataSource\";\nimport { instructionInfoTypes } from \"@/modules/solana/instruction-info/di/instructionInfoTypes\";\nimport { InstructionInfoContextLoader } from \"@/modules/solana/instruction-info/domain/InstructionInfoContextLoader\";\n\nexport const instructionInfoModuleFactory = () =>\n  new ContainerModule(({ bind }) => {\n    bind(instructionInfoTypes.InstructionInfoDataSource).to(\n      HttpInstructionInfoDataSource,\n    );\n    bind(instructionInfoTypes.InstructionInfoContextLoader).to(\n      InstructionInfoContextLoader,\n    );\n  });\n"],
-  "mappings": "AAAA,OAAS,mBAAAA,MAAuB,YAEhC,OAAS,iCAAAC,MAAqC,uEAC9C,OAAS,wBAAAC,MAA4B,4DACrC,OAAS,gCAAAC,MAAoC,wEAEtC,MAAMC,EAA+B,IAC1C,IAAIJ,EAAgB,CAAC,CAAE,KAAAK,CAAK,IAAM,CAChCA,EAAKH,EAAqB,yBAAyB,EAAE,GACnDD,CACF,EACAI,EAAKH,EAAqB,4BAA4B,EAAE,GACtDC,CACF,CACF,CAAC",
-  "names": ["ContainerModule", "HttpInstructionInfoDataSource", "instructionInfoTypes", "InstructionInfoContextLoader", "instructionInfoModuleFactory", "bind"]
+  "sourcesContent": ["import { ContainerModule } from \"inversify\";\n\nimport { HttpInstructionInfoDataSource } from \"@/modules/solana/instruction-info/data/HttpInstructionInfoDataSource\";\nimport { instructionInfoTypes } from \"@/modules/solana/instruction-info/di/instructionInfoTypes\";\nimport { InstructionInfoContextLoader } from \"@/modules/solana/instruction-info/domain/InstructionInfoContextLoader\";\nimport { SolanaBasicFlowRuleContextLoader } from \"@/modules/solana/instruction-info/domain/SolanaBasicFlowRuleContextLoader\";\n\nexport const instructionInfoModuleFactory = () =>\n  new ContainerModule(({ bind }) => {\n    // Singleton so every consumer (instruction-info, enum-variant and\n    // basic-flow rules loaders) shares the data source's response cache.\n    bind(instructionInfoTypes.InstructionInfoDataSource)\n      .to(HttpInstructionInfoDataSource)\n      .inSingletonScope();\n    bind(instructionInfoTypes.InstructionInfoContextLoader).to(\n      InstructionInfoContextLoader,\n    );\n    bind(instructionInfoTypes.SolanaBasicFlowRuleContextLoader).to(\n      SolanaBasicFlowRuleContextLoader,\n    );\n  });\n"],
+  "mappings": "AAAA,OAAS,mBAAAA,MAAuB,YAEhC,OAAS,iCAAAC,MAAqC,uEAC9C,OAAS,wBAAAC,MAA4B,4DACrC,OAAS,gCAAAC,MAAoC,wEAC7C,OAAS,oCAAAC,MAAwC,4EAE1C,MAAMC,EAA+B,IAC1C,IAAIL,EAAgB,CAAC,CAAE,KAAAM,CAAK,IAAM,CAGhCA,EAAKJ,EAAqB,yBAAyB,EAChD,GAAGD,CAA6B,EAChC,iBAAiB,EACpBK,EAAKJ,EAAqB,4BAA4B,EAAE,GACtDC,CACF,EACAG,EAAKJ,EAAqB,gCAAgC,EAAE,GAC1DE,CACF,CACF,CAAC",
+  "names": ["ContainerModule", "HttpInstructionInfoDataSource", "instructionInfoTypes", "InstructionInfoContextLoader", "SolanaBasicFlowRuleContextLoader", "instructionInfoModuleFactory", "bind"]
 }

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoModuleFactory.test.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import{Container as a}from"inversify";import{describe as s,expect as c,it as f,vi as t}from"vitest";import{configTypes as n}from"../../../../config/di/configTypes";import{pkiTypes as u}from"../../../../modules/multichain/pki/di/pkiTypes";import{networkTypes as d}from"../../../../shared/network/di/networkTypes";import{instructionInfoModuleFactory as m}from"./instructionInfoModuleFactory";import{instructionInfoTypes as e}from"./instructionInfoTypes";s("instructionInfoModuleFactory",()=>{f("binds the data source as a singleton so its cache is shared",()=>{const o=new a;o.bind(n.Config).toConstantValue({}),o.bind(d.NetworkClient).toConstantValue({}),o.bind(u.PkiCertificateLoader).toConstantValue({}),o.bind(n.ContextModuleLoggerFactory).toConstantValue(()=>({debug:t.fn(),warn:t.fn()})),o.loadSync(m());const i=o.get(e.InstructionInfoDataSource),r=o.get(e.InstructionInfoDataSource);c(i).toBe(r)})});
2	+ //# sourceMappingURL=instructionInfoModuleFactory.test.js.map

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoModuleFactory.test.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/solana/instruction-info/di/instructionInfoModuleFactory.test.ts"],
+  "sourcesContent": ["import { Container } from \"inversify\";\nimport { describe, expect, it, vi } from \"vitest\";\n\nimport { configTypes } from \"@/config/di/configTypes\";\nimport { pkiTypes } from \"@/modules/multichain/pki/di/pkiTypes\";\nimport { networkTypes } from \"@/shared/network/di/networkTypes\";\n\nimport { instructionInfoModuleFactory } from \"./instructionInfoModuleFactory\";\nimport { instructionInfoTypes } from \"./instructionInfoTypes\";\n\ndescribe(\"instructionInfoModuleFactory\", () => {\n  it(\"binds the data source as a singleton so its cache is shared\", () => {\n    const container = new Container();\n    container.bind(configTypes.Config).toConstantValue({});\n    container.bind(networkTypes.NetworkClient).toConstantValue({});\n    container.bind(pkiTypes.PkiCertificateLoader).toConstantValue({});\n    container\n      .bind(configTypes.ContextModuleLoggerFactory)\n      .toConstantValue(() => ({ debug: vi.fn(), warn: vi.fn() }));\n    container.loadSync(instructionInfoModuleFactory());\n\n    const first = container.get(instructionInfoTypes.InstructionInfoDataSource);\n    const second = container.get(\n      instructionInfoTypes.InstructionInfoDataSource,\n    );\n    expect(first).toBe(second);\n  });\n});\n"],
+  "mappings": "AAAA,OAAS,aAAAA,MAAiB,YAC1B,OAAS,YAAAC,EAAU,UAAAC,EAAQ,MAAAC,EAAI,MAAAC,MAAU,SAEzC,OAAS,eAAAC,MAAmB,0BAC5B,OAAS,YAAAC,MAAgB,uCACzB,OAAS,gBAAAC,MAAoB,mCAE7B,OAAS,gCAAAC,MAAoC,iCAC7C,OAAS,wBAAAC,MAA4B,yBAErCR,EAAS,+BAAgC,IAAM,CAC7CE,EAAG,8DAA+D,IAAM,CACtE,MAAMO,EAAY,IAAIV,EACtBU,EAAU,KAAKL,EAAY,MAAM,EAAE,gBAAgB,CAAC,CAAC,EACrDK,EAAU,KAAKH,EAAa,aAAa,EAAE,gBAAgB,CAAC,CAAC,EAC7DG,EAAU,KAAKJ,EAAS,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,EAChEI,EACG,KAAKL,EAAY,0BAA0B,EAC3C,gBAAgB,KAAO,CAAE,MAAOD,EAAG,GAAG,EAAG,KAAMA,EAAG,GAAG,CAAE,EAAE,EAC5DM,EAAU,SAASF,EAA6B,CAAC,EAEjD,MAAMG,EAAQD,EAAU,IAAID,EAAqB,yBAAyB,EACpEG,EAASF,EAAU,IACvBD,EAAqB,yBACvB,EACAP,EAAOS,CAAK,EAAE,KAAKC,CAAM,CAC3B,CAAC,CACH,CAAC",
+  "names": ["Container", "describe", "expect", "it", "vi", "configTypes", "pkiTypes", "networkTypes", "instructionInfoModuleFactory", "instructionInfoTypes", "container", "first", "second"]
+}

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoTypes.js CHANGED Viewed

@@ -1,2 +1,2 @@
-const o={InstructionInfoDataSource:Symbol.for("InstructionInfoDataSource"),InstructionInfoContextLoader:Symbol.for("InstructionInfoContextLoader")};export{o as instructionInfoTypes};
+const o={InstructionInfoDataSource:Symbol.for("InstructionInfoDataSource"),InstructionInfoContextLoader:Symbol.for("InstructionInfoContextLoader"),SolanaBasicFlowRuleContextLoader:Symbol.for("SolanaBasicFlowRuleContextLoader")};export{o as instructionInfoTypes};
 //# sourceMappingURL=instructionInfoTypes.js.map

package/lib/esm/src/modules/solana/instruction-info/di/instructionInfoTypes.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/di/instructionInfoTypes.ts"],
-  "sourcesContent": ["export const instructionInfoTypes = {\n  InstructionInfoDataSource: Symbol.for(\"InstructionInfoDataSource\"),\n  InstructionInfoContextLoader: Symbol.for(\"InstructionInfoContextLoader\"),\n};\n"],
-  "mappings": "AAAO,MAAMA,EAAuB,CAClC,0BAA2B,OAAO,IAAI,2BAA2B,EACjE,6BAA8B,OAAO,IAAI,8BAA8B,CACzE",
+  "sourcesContent": ["export const instructionInfoTypes = {\n  InstructionInfoDataSource: Symbol.for(\"InstructionInfoDataSource\"),\n  InstructionInfoContextLoader: Symbol.for(\"InstructionInfoContextLoader\"),\n  SolanaBasicFlowRuleContextLoader: Symbol.for(\n    \"SolanaBasicFlowRuleContextLoader\",\n  ),\n};\n"],
+  "mappings": "AAAO,MAAMA,EAAuB,CAClC,0BAA2B,OAAO,IAAI,2BAA2B,EACjE,6BAA8B,OAAO,IAAI,8BAA8B,EACvE,iCAAkC,OAAO,IACvC,kCACF,CACF",
   "names": ["instructionInfoTypes"]
 }

package/lib/esm/src/modules/solana/instruction-info/domain/InstructionInfoContextLoader.test.js CHANGED Viewed

@@ -1,2 +1,2 @@
-import{DeviceModelId as u}from"@ledgerhq/device-management-kit";import{Left as g,Right as d}from"purify-ts";import{beforeEach as v,describe as O,expect as e,it as I,vi as s}from"vitest";import{ClearSignContextType as i}from"../../../../shared/model/ClearSignContext";import{InstructionInfoContextLoader as S}from"./InstructionInfoContextLoader";const w=()=>({debug:s.fn(),info:s.fn(),warn:s.fn(),error:s.fn(),subscribers:[]}),A={keyUsageNumber:8,payload:new Uint8Array([66])},a="11111111111111111111111111111111",m="JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4";function y(){return{programId:a,discriminator:"00000000",instructionInfo:{data:"0001sys_data",signature:"prodsig_sys"},substructures:[{kind:0,data:"df1"},{kind:0,data:"df2"},{kind:1,data:"vfp1"}],enumVariants:[],idlDescriptor:{typePool:[],rootType:0},mintAssociations:[],ownerAssociations:[],valueFlowPorts:[],accountResets:[],displayFields:[],hideRules:[]}}function f(){return{programId:a,descriptors:{"00000000":d(y())},enumVariants:[]}}function _(){return{programId:m,discriminator:"e517cb977ae3ad2a",instructionInfo:{data:"0001jup_data",signature:"prodsig_jup"},substructures:[],enumVariants:[],idlDescriptor:{typePool:[],rootType:0},mintAssociations:[],ownerAssociations:[],valueFlowPorts:[],accountResets:[],displayFields:[],hideRules:[]}}function h(){return{programId:m,descriptors:{e517cb977ae3ad2a:d(_())},enumVariants:[]}}function R(c=[]){return{programId:m,descriptors:{e517cb977ae3ad2a:d({..._(),enumVariants:c})},enumVariants:c}}O("InstructionInfoContextLoader",()=>{let c,N;v(()=>{s.restoreAllMocks(),c={getInstructionInfo:s.fn()},N={loadCertificate:s.fn().mockResolvedValue(A)}});const l=()=>new S(c,N,w);O("canHandle",()=>{I("returns true when SOLANA_INSTRUCTION_INFO is requested and instructions are present",()=>{e(l().canHandle({deviceModelId:u.NANO_X,instructions:[{programId:a}]},[i.SOLANA_INSTRUCTION_INFO])).toBe(!0)}),I("returns false when SOLANA_INSTRUCTION_INFO is not requested",()=>{e(l().canHandle({deviceModelId:u.NANO_X,instructions:[{programId:a}]},[i.SOLANA_TOKEN])).toBe(!1)}),I("returns false on missing / empty / malformed instructions",()=>{const o=l(),t=[i.SOLANA_INSTRUCTION_INFO];e(o.canHandle({},t)).toBe(!1),e(o.canHandle({instructions:[]},t)).toBe(!1),e(o.canHandle({instructions:[{programId:""}]},t)).toBe(!1),e(o.canHandle(null,t)).toBe(!1),e(o.canHandle("string",t)).toBe(!1)})}),O("load",()=>{I("fans out one CAL call per distinct programId in parallel",async()=>{const o=l(),t=s.spyOn(c,"getInstructionInfo").mockImplementation(async({programId:r})=>r===a?d(f()):r===m?d(h()):g(new Error("unknown program"))),n=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a,discriminator:"00000000"},{programId:a,discriminator:"00000000"},{programId:m,discriminator:"e517cb977ae3ad2a"}],network:"solana-mainnet"});e(t).toHaveBeenCalledTimes(2),e(t).toHaveBeenCalledWith({programId:a,network:"solana-mainnet"}),e(t).toHaveBeenCalledWith({programId:m,network:"solana-mainnet"}),e(n.every(r=>r.type===i.SOLANA_INSTRUCTION_INFO||r.type===i.ERROR)).toBe(!0),e(n.filter(r=>r.type===i.SOLANA_INSTRUCTION_INFO)).toHaveLength(2)}),I("emits one SOLANA_INSTRUCTION_INFO per matching (programId, discriminator), passing the decoded payload through with the certificate",async()=>{const o=l();s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const n=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a,discriminator:"00000000"}]})).find(r=>r.type===i.SOLANA_INSTRUCTION_INFO);e(n).toBeDefined(),e(n).toMatchObject({type:i.SOLANA_INSTRUCTION_INFO,certificate:A}),e(n.payload).toEqual(y())}),I("does NOT emit SOLANA_ENUM_VARIANT contexts (those come from EnumVariantContextLoader)",async()=>{const o=l(),t=R([{enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}}]);s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const n=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]});e(n.filter(r=>r.type===i.SOLANA_ENUM_VARIANT)).toHaveLength(0)}),I("bundles CAL enum_variants into the SOLANA_INSTRUCTION_INFO payload (host decode cache)",async()=>{const o=l(),t=[{enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}}];s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(R(t)));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]})).find(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r.payload.enumVariants).toEqual(t)}),I("forwards exactly the enumVariants the data source decoded \u2014 no NaN indices",async()=>{const o=l(),t={enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(R([t])));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]})).find(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r.payload.enumVariants).toEqual([t])}),I("filters descriptors by requested discriminator",async()=>{const o=l(),t={programId:a,descriptors:{"00000000":d(y()),"00000001":d({...y(),discriminator:"00000001",instructionInfo:{data:"0001other",signature:"p"}})},enumVariants:[]};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a,discriminator:"00000000"}]})).filter(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r).toHaveLength(1),e(r[0].payload.discriminator).toBe("00000000")}),I("emits an ERROR context for a descriptor the data source could not decode",async()=>{const o=l(),t={programId:a,descriptors:{"00000000":g(new Error("missing 'test' signature"))},enumVariants:[]};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const n=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a,discriminator:"00000000"}]});e(n).toHaveLength(1),e(n[0]?.type).toBe(i.ERROR),e(n[0].error.message).toMatch(/missing 'test' signature/)}),I("emits one ERROR context when CAL fails for a program but keeps processing the others",async()=>{const o=l();s.spyOn(c,"getInstructionInfo").mockImplementation(async({programId:p})=>p===a?d(f()):g(new Error("upstream-500")));const t=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a,discriminator:"00000000"},{programId:m,discriminator:"e517cb977ae3ad2a"}]}),n=t.filter(p=>p.type===i.ERROR),r=t.filter(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(n).toHaveLength(1),e(r).toHaveLength(1)}),I("degrades every program to ERROR when certificate loading fails",async()=>{s.spyOn(N,"loadCertificate").mockRejectedValue(new Error("pki-down")),s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const t=await l().load({deviceModelId:u.NANO_X,instructions:[{programId:a},{programId:m}]});e(t).toHaveLength(2),e(t.every(n=>n.type===i.ERROR)).toBe(!0)}),I("degrades every program to ERROR when the certificate resolves undefined",async()=>{s.spyOn(N,"loadCertificate").mockResolvedValue(void 0),s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const t=await l().load({deviceModelId:u.NANO_X,instructions:[{programId:a},{programId:m}]});e(t).toHaveLength(2),e(t.every(n=>n.type===i.ERROR)).toBe(!0),e(t[0].error.message).toMatch(/certificate is missing/)}),I("falls back to default network when input.network is omitted or empty string",async()=>{const o=l(),t=s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a}]}),e(t).toHaveBeenLastCalledWith({programId:a,network:"solana-mainnet"}),await o.load({deviceModelId:u.NANO_X,instructions:[{programId:a}],network:""}),e(t).toHaveBeenLastCalledWith({programId:a,network:"solana-mainnet"})})})});
+import{DeviceModelId as u}from"@ledgerhq/device-management-kit";import{Left as g,Right as d}from"purify-ts";import{beforeEach as v,describe as O,expect as e,it as I,vi as s}from"vitest";import{ClearSignContextType as i}from"../../../../shared/model/ClearSignContext";import{InstructionInfoContextLoader as w}from"./InstructionInfoContextLoader";const S=()=>({debug:s.fn(),info:s.fn(),warn:s.fn(),error:s.fn(),subscribers:[]}),A={keyUsageNumber:8,payload:new Uint8Array([66])},n="11111111111111111111111111111111",m="JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4";function y(){return{programId:n,discriminator:"00000000",instructionInfo:{data:"0001sys_data",signature:"prodsig_sys"},substructures:[{kind:0,data:"df1"},{kind:0,data:"df2"},{kind:1,data:"vfp1"}],enumVariants:[],idlDescriptor:{typePool:[],rootType:0},mintAssociations:[],ownerAssociations:[],valueFlowPorts:[],accountResets:[],displayFields:[],hideRules:[]}}function f(){return{programId:n,descriptors:{"00000000":d(y())},basicFlowTags:[],enumVariants:[]}}function _(){return{programId:m,discriminator:"e517cb977ae3ad2a",instructionInfo:{data:"0001jup_data",signature:"prodsig_jup"},substructures:[],enumVariants:[],idlDescriptor:{typePool:[],rootType:0},mintAssociations:[],ownerAssociations:[],valueFlowPorts:[],accountResets:[],displayFields:[],hideRules:[]}}function T(){return{programId:m,descriptors:{e517cb977ae3ad2a:d(_())},basicFlowTags:[],enumVariants:[]}}function R(c=[]){return{programId:m,descriptors:{e517cb977ae3ad2a:d({..._(),enumVariants:c})},enumVariants:c,basicFlowTags:[]}}O("InstructionInfoContextLoader",()=>{let c,N;v(()=>{s.restoreAllMocks(),c={getInstructionInfo:s.fn()},N={loadCertificate:s.fn().mockResolvedValue(A)}});const l=()=>new w(c,N,S);O("canHandle",()=>{I("returns true when SOLANA_INSTRUCTION_INFO is requested and instructions are present",()=>{e(l().canHandle({deviceModelId:u.NANO_X,instructions:[{programId:n}]},[i.SOLANA_INSTRUCTION_INFO])).toBe(!0)}),I("returns false when SOLANA_INSTRUCTION_INFO is not requested",()=>{e(l().canHandle({deviceModelId:u.NANO_X,instructions:[{programId:n}]},[i.SOLANA_TOKEN])).toBe(!1)}),I("returns false on missing / empty / malformed instructions",()=>{const o=l(),t=[i.SOLANA_INSTRUCTION_INFO];e(o.canHandle({},t)).toBe(!1),e(o.canHandle({instructions:[]},t)).toBe(!1),e(o.canHandle({instructions:[{programId:""}]},t)).toBe(!1),e(o.canHandle(null,t)).toBe(!1),e(o.canHandle("string",t)).toBe(!1)})}),O("load",()=>{I("fans out one CAL call per distinct programId in parallel",async()=>{const o=l(),t=s.spyOn(c,"getInstructionInfo").mockImplementation(async({programId:r})=>r===n?d(f()):r===m?d(T()):g(new Error("unknown program"))),a=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n,discriminator:"00000000"},{programId:n,discriminator:"00000000"},{programId:m,discriminator:"e517cb977ae3ad2a"}],network:"solana-mainnet"});e(t).toHaveBeenCalledTimes(2),e(t).toHaveBeenCalledWith({programId:n,network:"solana-mainnet"}),e(t).toHaveBeenCalledWith({programId:m,network:"solana-mainnet"}),e(a.every(r=>r.type===i.SOLANA_INSTRUCTION_INFO||r.type===i.ERROR)).toBe(!0),e(a.filter(r=>r.type===i.SOLANA_INSTRUCTION_INFO)).toHaveLength(2)}),I("emits one SOLANA_INSTRUCTION_INFO per matching (programId, discriminator), passing the decoded payload through with the certificate",async()=>{const o=l();s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const a=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n,discriminator:"00000000"}]})).find(r=>r.type===i.SOLANA_INSTRUCTION_INFO);e(a).toBeDefined(),e(a).toMatchObject({type:i.SOLANA_INSTRUCTION_INFO,certificate:A}),e(a.payload).toEqual(y())}),I("does NOT emit SOLANA_ENUM_VARIANT contexts (those come from EnumVariantContextLoader)",async()=>{const o=l(),t=R([{enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}}]);s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const a=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]});e(a.filter(r=>r.type===i.SOLANA_ENUM_VARIANT)).toHaveLength(0)}),I("bundles CAL enum_variants into the SOLANA_INSTRUCTION_INFO payload (host decode cache)",async()=>{const o=l(),t=[{enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}}];s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(R(t)));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]})).find(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r.payload.enumVariants).toEqual(t)}),I("forwards exactly the enumVariants the data source decoded \u2014 no NaN indices",async()=>{const o=l(),t={enumId:"swap",variantIndex:46,descriptor:{data:"01_raydium_tlv",signature:"prodsig_v46"}};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(R([t])));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:m,discriminator:"e517cb977ae3ad2a"}]})).find(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r.payload.enumVariants).toEqual([t])}),I("filters descriptors by requested discriminator",async()=>{const o=l(),t={programId:n,descriptors:{"00000000":d(y()),"00000001":d({...y(),discriminator:"00000001",instructionInfo:{data:"0001other",signature:"p"}})},enumVariants:[],basicFlowTags:[]};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const r=(await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n,discriminator:"00000000"}]})).filter(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(r).toHaveLength(1),e(r[0].payload.discriminator).toBe("00000000")}),I("emits an ERROR context for a descriptor the data source could not decode",async()=>{const o=l(),t={programId:n,descriptors:{"00000000":g(new Error("missing 'test' signature"))},enumVariants:[],basicFlowTags:[]};s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(t));const a=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n,discriminator:"00000000"}]});e(a).toHaveLength(1),e(a[0]?.type).toBe(i.ERROR),e(a[0].error.message).toMatch(/missing 'test' signature/)}),I("emits one ERROR context when CAL fails for a program but keeps processing the others",async()=>{const o=l();s.spyOn(c,"getInstructionInfo").mockImplementation(async({programId:p})=>p===n?d(f()):g(new Error("upstream-500")));const t=await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n,discriminator:"00000000"},{programId:m,discriminator:"e517cb977ae3ad2a"}]}),a=t.filter(p=>p.type===i.ERROR),r=t.filter(p=>p.type===i.SOLANA_INSTRUCTION_INFO);e(a).toHaveLength(1),e(r).toHaveLength(1)}),I("degrades every program to ERROR when certificate loading fails",async()=>{s.spyOn(N,"loadCertificate").mockRejectedValue(new Error("pki-down")),s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const t=await l().load({deviceModelId:u.NANO_X,instructions:[{programId:n},{programId:m}]});e(t).toHaveLength(2),e(t.every(a=>a.type===i.ERROR)).toBe(!0)}),I("degrades every program to ERROR when the certificate resolves undefined",async()=>{s.spyOn(N,"loadCertificate").mockResolvedValue(void 0),s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));const t=await l().load({deviceModelId:u.NANO_X,instructions:[{programId:n},{programId:m}]});e(t).toHaveLength(2),e(t.every(a=>a.type===i.ERROR)).toBe(!0),e(t[0].error.message).toMatch(/certificate is missing/)}),I("falls back to default network when input.network is omitted or empty string",async()=>{const o=l(),t=s.spyOn(c,"getInstructionInfo").mockResolvedValue(d(f()));await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n}]}),e(t).toHaveBeenLastCalledWith({programId:n,network:"solana-mainnet"}),await o.load({deviceModelId:u.NANO_X,instructions:[{programId:n}],network:""}),e(t).toHaveBeenLastCalledWith({programId:n,network:"solana-mainnet"})})})});
 //# sourceMappingURL=InstructionInfoContextLoader.test.js.map

package/lib/esm/src/modules/solana/instruction-info/domain/InstructionInfoContextLoader.test.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../src/modules/solana/instruction-info/domain/InstructionInfoContextLoader.test.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\nimport { DeviceModelId } from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { type PkiCertificateLoader } from \"@/modules/multichain/pki/domain/PkiCertificateLoader\";\nimport {\n  type InstructionInfoDataSource,\n  type InstructionInfoResult,\n} from \"@/modules/solana/instruction-info/data/InstructionInfoDataSource\";\nimport {\n  type SolanaInstructionEnumVariant,\n  type SolanaInstructionInfoPayload,\n} from \"@/modules/solana/model/SolanaPayloads\";\nimport { ClearSignContextType } from \"@/shared/model/ClearSignContext\";\n\nimport { InstructionInfoContextLoader } from \"./InstructionInfoContextLoader\";\n\nconst mockLoggerFactory = () => ({\n  debug: vi.fn(),\n  info: vi.fn(),\n  warn: vi.fn(),\n  error: vi.fn(),\n  subscribers: [],\n});\n\nconst mockCertificate = {\n  keyUsageNumber: 8,\n  payload: new Uint8Array([0x42]),\n};\n\nconst SYSTEM_PROGRAM = \"11111111111111111111111111111111\";\nconst JUPITER_PROGRAM = \"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\";\n\n// The data source hands the loader fully-decoded core payloads.\nfunction makeSystemPayload(): SolanaInstructionInfoPayload {\n  return {\n    programId: SYSTEM_PROGRAM,\n    discriminator: \"00000000\",\n    instructionInfo: { data: \"0001sys_data\", signature: \"prodsig_sys\" },\n    substructures: [\n      { kind: 0x00, data: \"df1\" },\n      { kind: 0x00, data: \"df2\" },\n      { kind: 0x01, data: \"vfp1\" },\n    ],\n    enumVariants: [],\n    idlDescriptor: { typePool: [], rootType: 0 },\n    mintAssociations: [],\n    ownerAssociations: [],\n    valueFlowPorts: [],\n    accountResets: [],\n    displayFields: [],\n    hideRules: [],\n  };\n}\n\nfunction makeSystemResult(): InstructionInfoResult {\n  return {\n    programId: SYSTEM_PROGRAM,\n    descriptors: { \"00000000\": Right(makeSystemPayload()) },\n    enumVariants: [],\n  };\n}\n\nfunction makeJupiterPayload(): SolanaInstructionInfoPayload {\n  return {\n    programId: JUPITER_PROGRAM,\n    discriminator: \"e517cb977ae3ad2a\",\n    instructionInfo: { data: \"0001jup_data\", signature: \"prodsig_jup\" },\n    substructures: [],\n    enumVariants: [],\n    idlDescriptor: { typePool: [], rootType: 0 },\n    mintAssociations: [],\n    ownerAssociations: [],\n    valueFlowPorts: [],\n    accountResets: [],\n    displayFields: [],\n    hideRules: [],\n  };\n}\n\nfunction makeJupiterResult(): InstructionInfoResult {\n  return {\n    programId: JUPITER_PROGRAM,\n    descriptors: { e517cb977ae3ad2a: Right(makeJupiterPayload()) },\n    enumVariants: [],\n  };\n}\n\nfunction makeJupiterRouteResult(\n  enumVariants: SolanaInstructionEnumVariant[] = [],\n): InstructionInfoResult {\n  return {\n    programId: JUPITER_PROGRAM,\n    descriptors: {\n      e517cb977ae3ad2a: Right({ ...makeJupiterPayload(), enumVariants }),\n    },\n    enumVariants,\n  };\n}\n\ndescribe(\"InstructionInfoContextLoader\", () => {\n  let dataSource: InstructionInfoDataSource;\n  let certificateLoader: PkiCertificateLoader;\n\n  beforeEach(() => {\n    vi.restoreAllMocks();\n    dataSource = {\n      getInstructionInfo: vi.fn(),\n    };\n    certificateLoader = {\n      loadCertificate: vi.fn().mockResolvedValue(mockCertificate),\n    };\n  });\n\n  const makeLoader = () =>\n    new InstructionInfoContextLoader(\n      dataSource,\n      certificateLoader,\n      mockLoggerFactory,\n    );\n\n  describe(\"canHandle\", () => {\n    it(\"returns true when SOLANA_INSTRUCTION_INFO is requested and instructions are present\", () => {\n      expect(\n        makeLoader().canHandle(\n          {\n            deviceModelId: DeviceModelId.NANO_X,\n            instructions: [{ programId: SYSTEM_PROGRAM }],\n          },\n          [ClearSignContextType.SOLANA_INSTRUCTION_INFO],\n        ),\n      ).toBe(true);\n    });\n\n    it(\"returns false when SOLANA_INSTRUCTION_INFO is not requested\", () => {\n      expect(\n        makeLoader().canHandle(\n          {\n            deviceModelId: DeviceModelId.NANO_X,\n            instructions: [{ programId: SYSTEM_PROGRAM }],\n          },\n          [ClearSignContextType.SOLANA_TOKEN],\n        ),\n      ).toBe(false);\n    });\n\n    it(\"returns false on missing / empty / malformed instructions\", () => {\n      const loader = makeLoader();\n      const types = [ClearSignContextType.SOLANA_INSTRUCTION_INFO];\n      expect(loader.canHandle({} as any, types)).toBe(false);\n      expect(loader.canHandle({ instructions: [] } as any, types)).toBe(false);\n      expect(\n        loader.canHandle({ instructions: [{ programId: \"\" }] } as any, types),\n      ).toBe(false);\n      expect(loader.canHandle(null, types)).toBe(false);\n      expect(loader.canHandle(\"string\", types)).toBe(false);\n    });\n  });\n\n  describe(\"load\", () => {\n    it(\"fans out one CAL call per distinct programId in parallel\", async () => {\n      const loader = makeLoader();\n      const spy = vi\n        .spyOn(dataSource, \"getInstructionInfo\")\n        .mockImplementation(async ({ programId }) => {\n          if (programId === SYSTEM_PROGRAM) return Right(makeSystemResult());\n          if (programId === JUPITER_PROGRAM) return Right(makeJupiterResult());\n          return Left(new Error(\"unknown program\"));\n        });\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" }, // dup\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n        network: \"solana-mainnet\",\n      });\n\n      expect(spy).toHaveBeenCalledTimes(2);\n      expect(spy).toHaveBeenCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n      expect(spy).toHaveBeenCalledWith({\n        programId: JUPITER_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n\n      expect(\n        result.every(\n          (c) =>\n            c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO ||\n            c.type === ClearSignContextType.ERROR,\n        ),\n      ).toBe(true);\n      expect(\n        result.filter(\n          (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n        ),\n      ).toHaveLength(2);\n    });\n\n    it(\"emits one SOLANA_INSTRUCTION_INFO per matching (programId, discriminator), passing the decoded payload through with the certificate\", async () => {\n      const loader = makeLoader();\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(infoCtx).toBeDefined();\n      expect(infoCtx).toMatchObject({\n        type: ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n        certificate: mockCertificate,\n      });\n      // The loader does not transform \u2014 it forwards the data source's payload.\n      expect((infoCtx as any).payload).toEqual(makeSystemPayload());\n    });\n\n    it(\"does NOT emit SOLANA_ENUM_VARIANT contexts (those come from EnumVariantContextLoader)\", async () => {\n      const loader = makeLoader();\n      // Pass a pre-decoded variant to confirm the loader never emits SOLANA_ENUM_VARIANT.\n      const jupiter = makeJupiterRouteResult([\n        {\n          enumId: \"swap\",\n          variantIndex: 46,\n          descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n        },\n      ]);\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(jupiter),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      expect(\n        result.filter(\n          (c) => c.type === ClearSignContextType.SOLANA_ENUM_VARIANT,\n        ),\n      ).toHaveLength(0);\n    });\n\n    it(\"bundles CAL enum_variants into the SOLANA_INSTRUCTION_INFO payload (host decode cache)\", async () => {\n      const loader = makeLoader();\n      const expectedVariants: SolanaInstructionEnumVariant[] = [\n        {\n          enumId: \"swap\",\n          variantIndex: 46,\n          descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n        },\n      ];\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeJupiterRouteResult(expectedVariants)),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n\n      expect((infoCtx as any).payload.enumVariants).toEqual(expectedVariants);\n    });\n\n    it(\"forwards exactly the enumVariants the data source decoded \u2014 no NaN indices\", async () => {\n      const loader = makeLoader();\n      // The data source is responsible for filtering malformed variant keys;\n      // the loader forwards whatever pre-decoded variants it receives as-is.\n      const validVariant: SolanaInstructionEnumVariant = {\n        enumId: \"swap\",\n        variantIndex: 46,\n        descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeJupiterRouteResult([validVariant])),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n\n      expect((infoCtx as any).payload.enumVariants).toEqual([validVariant]);\n    });\n\n    it(\"filters descriptors by requested discriminator\", async () => {\n      const loader = makeLoader();\n      const result: InstructionInfoResult = {\n        programId: SYSTEM_PROGRAM,\n        descriptors: {\n          \"00000000\": Right(makeSystemPayload()),\n          \"00000001\": Right({\n            ...makeSystemPayload(),\n            discriminator: \"00000001\",\n            instructionInfo: { data: \"0001other\", signature: \"p\" },\n          }),\n        },\n        enumVariants: [],\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(result),\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      const infos = out.filter(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(infos).toHaveLength(1);\n      expect((infos[0] as any).payload.discriminator).toBe(\"00000000\");\n    });\n\n    it(\"emits an ERROR context for a descriptor the data source could not decode\", async () => {\n      const loader = makeLoader();\n      const result: InstructionInfoResult = {\n        programId: SYSTEM_PROGRAM,\n        descriptors: {\n          \"00000000\": Left(new Error(\"missing 'test' signature\")),\n        },\n        enumVariants: [],\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(result),\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      expect(out).toHaveLength(1);\n      expect(out[0]?.type).toBe(ClearSignContextType.ERROR);\n      expect((out[0] as any).error.message).toMatch(/missing 'test' signature/);\n    });\n\n    it(\"emits one ERROR context when CAL fails for a program but keeps processing the others\", async () => {\n      const loader = makeLoader();\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockImplementation(\n        async ({ programId }) => {\n          if (programId === SYSTEM_PROGRAM) return Right(makeSystemResult());\n          return Left(new Error(\"upstream-500\"));\n        },\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const errors = out.filter((c) => c.type === ClearSignContextType.ERROR);\n      const infos = out.filter(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(errors).toHaveLength(1);\n      expect(infos).toHaveLength(1);\n    });\n\n    it(\"degrades every program to ERROR when certificate loading fails\", async () => {\n      vi.spyOn(certificateLoader, \"loadCertificate\").mockRejectedValue(\n        new Error(\"pki-down\"),\n      );\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n      const loader = makeLoader();\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM },\n          { programId: JUPITER_PROGRAM },\n        ],\n      });\n\n      expect(out).toHaveLength(2);\n      expect(out.every((c) => c.type === ClearSignContextType.ERROR)).toBe(\n        true,\n      );\n    });\n\n    it(\"degrades every program to ERROR when the certificate resolves undefined\", async () => {\n      vi.spyOn(certificateLoader, \"loadCertificate\").mockResolvedValue(\n        undefined,\n      );\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n      const loader = makeLoader();\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM },\n          { programId: JUPITER_PROGRAM },\n        ],\n      });\n\n      expect(out).toHaveLength(2);\n      expect(out.every((c) => c.type === ClearSignContextType.ERROR)).toBe(\n        true,\n      );\n      expect((out[0] as any).error.message).toMatch(/certificate is missing/);\n    });\n\n    it(\"falls back to default network when input.network is omitted or empty string\", async () => {\n      const loader = makeLoader();\n      const spy = vi\n        .spyOn(dataSource, \"getInstructionInfo\")\n        .mockResolvedValue(Right(makeSystemResult()));\n\n      await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [{ programId: SYSTEM_PROGRAM }],\n      });\n      expect(spy).toHaveBeenLastCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n\n      await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [{ programId: SYSTEM_PROGRAM }],\n        network: \"\",\n      });\n      expect(spy).toHaveBeenLastCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n    });\n  });\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\nimport { DeviceModelId } from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { type PkiCertificateLoader } from \"@/modules/multichain/pki/domain/PkiCertificateLoader\";\nimport {\n  type InstructionInfoDataSource,\n  type InstructionInfoResult,\n} from \"@/modules/solana/instruction-info/data/InstructionInfoDataSource\";\nimport {\n  type SolanaInstructionEnumVariant,\n  type SolanaInstructionInfoPayload,\n} from \"@/modules/solana/model/SolanaPayloads\";\nimport { ClearSignContextType } from \"@/shared/model/ClearSignContext\";\n\nimport { InstructionInfoContextLoader } from \"./InstructionInfoContextLoader\";\n\nconst mockLoggerFactory = () => ({\n  debug: vi.fn(),\n  info: vi.fn(),\n  warn: vi.fn(),\n  error: vi.fn(),\n  subscribers: [],\n});\n\nconst mockCertificate = {\n  keyUsageNumber: 8,\n  payload: new Uint8Array([0x42]),\n};\n\nconst SYSTEM_PROGRAM = \"11111111111111111111111111111111\";\nconst JUPITER_PROGRAM = \"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4\";\n\n// The data source hands the loader fully-decoded core payloads.\nfunction makeSystemPayload(): SolanaInstructionInfoPayload {\n  return {\n    programId: SYSTEM_PROGRAM,\n    discriminator: \"00000000\",\n    instructionInfo: { data: \"0001sys_data\", signature: \"prodsig_sys\" },\n    substructures: [\n      { kind: 0x00, data: \"df1\" },\n      { kind: 0x00, data: \"df2\" },\n      { kind: 0x01, data: \"vfp1\" },\n    ],\n    enumVariants: [],\n    idlDescriptor: { typePool: [], rootType: 0 },\n    mintAssociations: [],\n    ownerAssociations: [],\n    valueFlowPorts: [],\n    accountResets: [],\n    displayFields: [],\n    hideRules: [],\n  };\n}\n\nfunction makeSystemResult(): InstructionInfoResult {\n  return {\n    programId: SYSTEM_PROGRAM,\n    descriptors: { \"00000000\": Right(makeSystemPayload()) },\n    basicFlowTags: [],\n    enumVariants: [],\n  };\n}\n\nfunction makeJupiterPayload(): SolanaInstructionInfoPayload {\n  return {\n    programId: JUPITER_PROGRAM,\n    discriminator: \"e517cb977ae3ad2a\",\n    instructionInfo: { data: \"0001jup_data\", signature: \"prodsig_jup\" },\n    substructures: [],\n    enumVariants: [],\n    idlDescriptor: { typePool: [], rootType: 0 },\n    mintAssociations: [],\n    ownerAssociations: [],\n    valueFlowPorts: [],\n    accountResets: [],\n    displayFields: [],\n    hideRules: [],\n  };\n}\n\nfunction makeJupiterResult(): InstructionInfoResult {\n  return {\n    programId: JUPITER_PROGRAM,\n    descriptors: { e517cb977ae3ad2a: Right(makeJupiterPayload()) },\n    basicFlowTags: [],\n    enumVariants: [],\n  };\n}\n\nfunction makeJupiterRouteResult(\n  enumVariants: SolanaInstructionEnumVariant[] = [],\n): InstructionInfoResult {\n  return {\n    programId: JUPITER_PROGRAM,\n    descriptors: {\n      e517cb977ae3ad2a: Right({ ...makeJupiterPayload(), enumVariants }),\n    },\n    enumVariants,\n    basicFlowTags: [],\n  };\n}\n\ndescribe(\"InstructionInfoContextLoader\", () => {\n  let dataSource: InstructionInfoDataSource;\n  let certificateLoader: PkiCertificateLoader;\n\n  beforeEach(() => {\n    vi.restoreAllMocks();\n    dataSource = {\n      getInstructionInfo: vi.fn(),\n    };\n    certificateLoader = {\n      loadCertificate: vi.fn().mockResolvedValue(mockCertificate),\n    };\n  });\n\n  const makeLoader = () =>\n    new InstructionInfoContextLoader(\n      dataSource,\n      certificateLoader,\n      mockLoggerFactory,\n    );\n\n  describe(\"canHandle\", () => {\n    it(\"returns true when SOLANA_INSTRUCTION_INFO is requested and instructions are present\", () => {\n      expect(\n        makeLoader().canHandle(\n          {\n            deviceModelId: DeviceModelId.NANO_X,\n            instructions: [{ programId: SYSTEM_PROGRAM }],\n          },\n          [ClearSignContextType.SOLANA_INSTRUCTION_INFO],\n        ),\n      ).toBe(true);\n    });\n\n    it(\"returns false when SOLANA_INSTRUCTION_INFO is not requested\", () => {\n      expect(\n        makeLoader().canHandle(\n          {\n            deviceModelId: DeviceModelId.NANO_X,\n            instructions: [{ programId: SYSTEM_PROGRAM }],\n          },\n          [ClearSignContextType.SOLANA_TOKEN],\n        ),\n      ).toBe(false);\n    });\n\n    it(\"returns false on missing / empty / malformed instructions\", () => {\n      const loader = makeLoader();\n      const types = [ClearSignContextType.SOLANA_INSTRUCTION_INFO];\n      expect(loader.canHandle({} as any, types)).toBe(false);\n      expect(loader.canHandle({ instructions: [] } as any, types)).toBe(false);\n      expect(\n        loader.canHandle({ instructions: [{ programId: \"\" }] } as any, types),\n      ).toBe(false);\n      expect(loader.canHandle(null, types)).toBe(false);\n      expect(loader.canHandle(\"string\", types)).toBe(false);\n    });\n  });\n\n  describe(\"load\", () => {\n    it(\"fans out one CAL call per distinct programId in parallel\", async () => {\n      const loader = makeLoader();\n      const spy = vi\n        .spyOn(dataSource, \"getInstructionInfo\")\n        .mockImplementation(async ({ programId }) => {\n          if (programId === SYSTEM_PROGRAM) return Right(makeSystemResult());\n          if (programId === JUPITER_PROGRAM) return Right(makeJupiterResult());\n          return Left(new Error(\"unknown program\"));\n        });\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" }, // dup\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n        network: \"solana-mainnet\",\n      });\n\n      expect(spy).toHaveBeenCalledTimes(2);\n      expect(spy).toHaveBeenCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n      expect(spy).toHaveBeenCalledWith({\n        programId: JUPITER_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n\n      expect(\n        result.every(\n          (c) =>\n            c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO ||\n            c.type === ClearSignContextType.ERROR,\n        ),\n      ).toBe(true);\n      expect(\n        result.filter(\n          (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n        ),\n      ).toHaveLength(2);\n    });\n\n    it(\"emits one SOLANA_INSTRUCTION_INFO per matching (programId, discriminator), passing the decoded payload through with the certificate\", async () => {\n      const loader = makeLoader();\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(infoCtx).toBeDefined();\n      expect(infoCtx).toMatchObject({\n        type: ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n        certificate: mockCertificate,\n      });\n      // The loader does not transform \u2014 it forwards the data source's payload.\n      expect((infoCtx as any).payload).toEqual(makeSystemPayload());\n    });\n\n    it(\"does NOT emit SOLANA_ENUM_VARIANT contexts (those come from EnumVariantContextLoader)\", async () => {\n      const loader = makeLoader();\n      // Pass a pre-decoded variant to confirm the loader never emits SOLANA_ENUM_VARIANT.\n      const jupiter = makeJupiterRouteResult([\n        {\n          enumId: \"swap\",\n          variantIndex: 46,\n          descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n        },\n      ]);\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(jupiter),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      expect(\n        result.filter(\n          (c) => c.type === ClearSignContextType.SOLANA_ENUM_VARIANT,\n        ),\n      ).toHaveLength(0);\n    });\n\n    it(\"bundles CAL enum_variants into the SOLANA_INSTRUCTION_INFO payload (host decode cache)\", async () => {\n      const loader = makeLoader();\n      const expectedVariants: SolanaInstructionEnumVariant[] = [\n        {\n          enumId: \"swap\",\n          variantIndex: 46,\n          descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n        },\n      ];\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeJupiterRouteResult(expectedVariants)),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n\n      expect((infoCtx as any).payload.enumVariants).toEqual(expectedVariants);\n    });\n\n    it(\"forwards exactly the enumVariants the data source decoded \u2014 no NaN indices\", async () => {\n      const loader = makeLoader();\n      // The data source is responsible for filtering malformed variant keys;\n      // the loader forwards whatever pre-decoded variants it receives as-is.\n      const validVariant: SolanaInstructionEnumVariant = {\n        enumId: \"swap\",\n        variantIndex: 46,\n        descriptor: { data: \"01_raydium_tlv\", signature: \"prodsig_v46\" },\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeJupiterRouteResult([validVariant])),\n      );\n\n      const result = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const infoCtx = result.find(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n\n      expect((infoCtx as any).payload.enumVariants).toEqual([validVariant]);\n    });\n\n    it(\"filters descriptors by requested discriminator\", async () => {\n      const loader = makeLoader();\n      const result: InstructionInfoResult = {\n        programId: SYSTEM_PROGRAM,\n        descriptors: {\n          \"00000000\": Right(makeSystemPayload()),\n          \"00000001\": Right({\n            ...makeSystemPayload(),\n            discriminator: \"00000001\",\n            instructionInfo: { data: \"0001other\", signature: \"p\" },\n          }),\n        },\n        enumVariants: [],\n        basicFlowTags: [],\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(result),\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      const infos = out.filter(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(infos).toHaveLength(1);\n      expect((infos[0] as any).payload.discriminator).toBe(\"00000000\");\n    });\n\n    it(\"emits an ERROR context for a descriptor the data source could not decode\", async () => {\n      const loader = makeLoader();\n      const result: InstructionInfoResult = {\n        programId: SYSTEM_PROGRAM,\n        descriptors: {\n          \"00000000\": Left(new Error(\"missing 'test' signature\")),\n        },\n        enumVariants: [],\n        basicFlowTags: [],\n      };\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(result),\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n        ],\n      });\n\n      expect(out).toHaveLength(1);\n      expect(out[0]?.type).toBe(ClearSignContextType.ERROR);\n      expect((out[0] as any).error.message).toMatch(/missing 'test' signature/);\n    });\n\n    it(\"emits one ERROR context when CAL fails for a program but keeps processing the others\", async () => {\n      const loader = makeLoader();\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockImplementation(\n        async ({ programId }) => {\n          if (programId === SYSTEM_PROGRAM) return Right(makeSystemResult());\n          return Left(new Error(\"upstream-500\"));\n        },\n      );\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM, discriminator: \"00000000\" },\n          { programId: JUPITER_PROGRAM, discriminator: \"e517cb977ae3ad2a\" },\n        ],\n      });\n\n      const errors = out.filter((c) => c.type === ClearSignContextType.ERROR);\n      const infos = out.filter(\n        (c) => c.type === ClearSignContextType.SOLANA_INSTRUCTION_INFO,\n      );\n      expect(errors).toHaveLength(1);\n      expect(infos).toHaveLength(1);\n    });\n\n    it(\"degrades every program to ERROR when certificate loading fails\", async () => {\n      vi.spyOn(certificateLoader, \"loadCertificate\").mockRejectedValue(\n        new Error(\"pki-down\"),\n      );\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n      const loader = makeLoader();\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM },\n          { programId: JUPITER_PROGRAM },\n        ],\n      });\n\n      expect(out).toHaveLength(2);\n      expect(out.every((c) => c.type === ClearSignContextType.ERROR)).toBe(\n        true,\n      );\n    });\n\n    it(\"degrades every program to ERROR when the certificate resolves undefined\", async () => {\n      vi.spyOn(certificateLoader, \"loadCertificate\").mockResolvedValue(\n        undefined,\n      );\n      vi.spyOn(dataSource, \"getInstructionInfo\").mockResolvedValue(\n        Right(makeSystemResult()),\n      );\n      const loader = makeLoader();\n\n      const out = await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [\n          { programId: SYSTEM_PROGRAM },\n          { programId: JUPITER_PROGRAM },\n        ],\n      });\n\n      expect(out).toHaveLength(2);\n      expect(out.every((c) => c.type === ClearSignContextType.ERROR)).toBe(\n        true,\n      );\n      expect((out[0] as any).error.message).toMatch(/certificate is missing/);\n    });\n\n    it(\"falls back to default network when input.network is omitted or empty string\", async () => {\n      const loader = makeLoader();\n      const spy = vi\n        .spyOn(dataSource, \"getInstructionInfo\")\n        .mockResolvedValue(Right(makeSystemResult()));\n\n      await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [{ programId: SYSTEM_PROGRAM }],\n      });\n      expect(spy).toHaveBeenLastCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n\n      await loader.load({\n        deviceModelId: DeviceModelId.NANO_X,\n        instructions: [{ programId: SYSTEM_PROGRAM }],\n        network: \"\",\n      });\n      expect(spy).toHaveBeenLastCalledWith({\n        programId: SYSTEM_PROGRAM,\n        network: \"solana-mainnet\",\n      });\n    });\n  });\n});\n"],
+  "mappings": "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",
   "names": ["DeviceModelId", "Left", "Right", "beforeEach", "describe", "expect", "it", "vi", "ClearSignContextType", "InstructionInfoContextLoader", "mockLoggerFactory", "mockCertificate", "SYSTEM_PROGRAM", "JUPITER_PROGRAM", "makeSystemPayload", "makeSystemResult", "makeJupiterPayload", "makeJupiterResult", "makeJupiterRouteResult", "enumVariants", "dataSource", "certificateLoader", "makeLoader", "loader", "types", "spy", "programId", "result", "c", "infoCtx", "jupiter", "expectedVariants", "validVariant", "infos", "out", "errors"]
 }

package/lib/esm/src/modules/solana/instruction-info/domain/SolanaBasicFlowRuleContextLoader.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ var I=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var m=(l,r,e,t)=>{for(var o=t>1?void 0:t?w(r,e):r,i=l.length-1,n;i>=0;i--)(n=l[i])&&(o=(t?n(r,e,o):n(o))\|\|o);return t&&o&&I(r,e,o),o},d=(l,r)=>(e,t)=>r(e,t,l);import{hexaStringToBuffer as C}from"@ledgerhq/device-management-kit";import{inject as y,injectable as L}from"inversify";import{array as x,Codec as b,Left as A,optional as F,Right as B,string as S}from"purify-ts";import{configTypes as E}from"../../../../config/di/configTypes";import{SolanaProgramNotFoundError as P}from"../../../../modules/solana/instruction-info/data/InstructionInfoDataSource";import{instructionInfoTypes as v}from"../../../../modules/solana/instruction-info/di/instructionInfoTypes";import{ClearSignContextType as f}from"../../../../shared/model/ClearSignContext";const M="solana-mainnet",T=[f.SOLANA_BASIC_FLOW_RULE],O=b.interface({programIds:x(S),network:F(S)});let g=class{constructor(r,e){this.dataSource=r;this.logger=e("SolanaBasicFlowRuleContextLoader")}logger;canHandle(r,e){return T.every(t=>e.includes(t))?O.decode(r).isRight():!1}async load(r){return(await this.loadRules(r)).caseOf({Left:t=>[{type:f.ERROR,error:t}],Right:t=>t.map(o=>({type:f.SOLANA_BASIC_FLOW_RULE,payload:o}))})}async loadRules({programIds:r,network:e}){const t=e\|\|M,o=Array.from(new Set(r)),i=await Promise.all(o.map(async a=>({programId:a,either:await this.dataSource.getInstructionInfo({programId:a,network:t})}))),n=[],c=[];for(const{programId:a,either:R}of i)R.caseOf({Left:p=>{if(p instanceof P){this.logger.debug("[load] Program not in CAL, no signing route",{data:{programId:a}});return}this.logger.warn("[load] Failed to fetch signing routes from CAL",{data:{programId:a,error:p.message}}),c.push(p)},Right:p=>{n.push(p)}});const[u]=c;if(u!==void 0)return A(u);const s=this.buildRules(n);return this.logger.debug("[load] Built basic-flow rules",{data:{rules:s.map(({id:a})=>a)}}),B(s)}buildRules(r){const e=new Map;for(const{programId:t,basicFlowTags:o}of r)for(const{discriminator:i,rule:n,role:c}of o){const u=C(i);if(u===null\|\|u.length===0){this.logger.warn("[load] Skipping tag with invalid discriminator",{data:{programId:t,discriminator:i,rule:n}});continue}let s=e.get(n);s===void 0&&(s={required:new Map,allowed:new Map},e.set(n,s));const a=s[c].get(t)??[];a.push(u),s[c].set(t,a)}return Array.from(e,([t,o])=>({id:t,required:h(o.required),allowed:h(o.allowed)}))}};g=m([L(),d(0,y(v.InstructionInfoDataSource)),d(1,y(E.ContextModuleLoggerFactory))],g);function h(l){return Array.from(l,([r,e])=>({programId:r,discriminators:e}))}export{g as SolanaBasicFlowRuleContextLoader};
2	+ //# sourceMappingURL=SolanaBasicFlowRuleContextLoader.js.map

package/lib/esm/src/modules/solana/instruction-info/domain/SolanaBasicFlowRuleContextLoader.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/solana/instruction-info/domain/SolanaBasicFlowRuleContextLoader.ts"],
+  "sourcesContent": ["import {\n  hexaStringToBuffer,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\nimport { inject, injectable } from \"inversify\";\nimport {\n  array,\n  Codec,\n  type Either,\n  Left,\n  optional,\n  Right,\n  string,\n} from \"purify-ts\";\n\nimport { configTypes } from \"@/config/di/configTypes\";\nimport {\n  type InstructionInfoDataSource,\n  type InstructionInfoResult,\n  SolanaProgramNotFoundError,\n} from \"@/modules/solana/instruction-info/data/InstructionInfoDataSource\";\nimport { instructionInfoTypes } from \"@/modules/solana/instruction-info/di/instructionInfoTypes\";\nimport {\n  type SolanaBasicFlowRule,\n  type SolanaInstructionMatcher,\n} from \"@/modules/solana/model/SolanaContextTypes\";\nimport { type ContextLoader } from \"@/shared/domain/ContextLoader\";\nimport {\n  type ClearSignContext,\n  ClearSignContextType,\n} from \"@/shared/model/ClearSignContext\";\n\nconst NETWORK_DEFAULT = \"solana-mainnet\";\n\nconst SUPPORTED_TYPES: ClearSignContextType[] = [\n  ClearSignContextType.SOLANA_BASIC_FLOW_RULE,\n];\n\nexport type SolanaBasicFlowRuleContextInput = {\n  programIds: string[];\n  network?: string;\n};\n\nconst solanaBasicFlowRuleInputCodec = Codec.interface({\n  programIds: array(string),\n  network: optional(string),\n});\n\ntype MatcherRole = \"required\" | \"allowed\";\n\n// Discriminators per program, in first-seen order, for one rule and role.\ntype RuleBuilder = Record<MatcherRole, Map<string, Uint8Array[]>>;\n\n/**\n * Rebuilds the basic-flow rules CAL tags on the given programs.\n *\n * CAL doesn't serve rules: it tags instructions with `{ rule, role }` in the\n * `solana_programs` response. Tags are grouped by rule id across programs,\n * giving one matcher per (program, role) with the tagged instructions'\n * discriminators. CAL rules always carry discriminators: CAL can't express\n * \"any instruction of this program\".\n *\n * Emits one SOLANA_BASIC_FLOW_RULE context per rule, or a single ERROR\n * context when any CAL lookup fails. A program CAL doesn't know just\n * contributes no tags.\n */\n@injectable()\nexport class SolanaBasicFlowRuleContextLoader\n  implements ContextLoader<SolanaBasicFlowRuleContextInput>\n{\n  private readonly logger: LoggerPublisherService;\n\n  constructor(\n    @inject(instructionInfoTypes.InstructionInfoDataSource)\n    private readonly dataSource: InstructionInfoDataSource,\n    @inject(configTypes.ContextModuleLoggerFactory)\n    loggerFactory: (tag: string) => LoggerPublisherService,\n  ) {\n    this.logger = loggerFactory(\"SolanaBasicFlowRuleContextLoader\");\n  }\n\n  public canHandle(\n    input: unknown,\n    expectedTypes: ClearSignContextType[],\n  ): input is SolanaBasicFlowRuleContextInput {\n    if (!SUPPORTED_TYPES.every((t) => expectedTypes.includes(t))) return false;\n    return solanaBasicFlowRuleInputCodec.decode(input).isRight();\n  }\n\n  public async load(\n    input: SolanaBasicFlowRuleContextInput,\n  ): Promise<ClearSignContext[]> {\n    const rules = await this.loadRules(input);\n    return rules.caseOf<ClearSignContext[]>({\n      Left: (error) => [{ type: ClearSignContextType.ERROR, error }],\n      Right: (loaded) =>\n        loaded.map((rule) => ({\n          type: ClearSignContextType.SOLANA_BASIC_FLOW_RULE,\n          payload: rule,\n        })),\n    });\n  }\n\n  private async loadRules({\n    programIds,\n    network,\n  }: SolanaBasicFlowRuleContextInput): Promise<\n    Either<Error, SolanaBasicFlowRule[]>\n  > {\n    const resolvedNetwork = network || NETWORK_DEFAULT;\n    const distinctProgramIds = Array.from(new Set(programIds));\n\n    const results = await Promise.all(\n      distinctProgramIds.map(async (programId) => ({\n        programId,\n        either: await this.dataSource.getInstructionInfo({\n          programId,\n          network: resolvedNetwork,\n        }),\n      })),\n    );\n\n    const programs: InstructionInfoResult[] = [];\n    const failures: Error[] = [];\n    for (const { programId, either } of results) {\n      either.caseOf<void>({\n        Left: (error) => {\n          if (error instanceof SolanaProgramNotFoundError) {\n            this.logger.debug(\"[load] Program not in CAL, no signing route\", {\n              data: { programId },\n            });\n            return;\n          }\n          this.logger.warn(\"[load] Failed to fetch signing routes from CAL\", {\n            data: { programId, error: error.message },\n          });\n          failures.push(error);\n        },\n        Right: (program) => {\n          programs.push(program);\n        },\n      });\n    }\n    const [failure] = failures;\n    if (failure !== undefined) {\n      return Left(failure);\n    }\n\n    const rules = this.buildRules(programs);\n    this.logger.debug(\"[load] Built basic-flow rules\", {\n      data: { rules: rules.map(({ id }) => id) },\n    });\n    return Right(rules);\n  }\n\n  private buildRules(programs: InstructionInfoResult[]): SolanaBasicFlowRule[] {\n    const builders = new Map<string, RuleBuilder>();\n\n    for (const { programId, basicFlowTags } of programs) {\n      for (const { discriminator, rule, role } of basicFlowTags) {\n        const bytes = hexaStringToBuffer(discriminator);\n        if (bytes === null || bytes.length === 0) {\n          this.logger.warn(\"[load] Skipping tag with invalid discriminator\", {\n            data: { programId, discriminator, rule },\n          });\n          continue;\n        }\n\n        let builder = builders.get(rule);\n        if (builder === undefined) {\n          builder = { required: new Map(), allowed: new Map() };\n          builders.set(rule, builder);\n        }\n        const discriminators = builder[role].get(programId) ?? [];\n        discriminators.push(bytes);\n        builder[role].set(programId, discriminators);\n      }\n    }\n\n    return Array.from(builders, ([id, builder]) => ({\n      id,\n      required: toMatchers(builder.required),\n      allowed: toMatchers(builder.allowed),\n    }));\n  }\n}\n\nfunction toMatchers(\n  byProgram: Map<string, Uint8Array[]>,\n): SolanaInstructionMatcher[] {\n  return Array.from(byProgram, ([programId, discriminators]) => ({\n    programId,\n    discriminators,\n  }));\n}\n"],
+  "mappings": "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",
+  "names": ["hexaStringToBuffer", "inject", "injectable", "array", "Codec", "Left", "optional", "Right", "string", "configTypes", "SolanaProgramNotFoundError", "instructionInfoTypes", "ClearSignContextType", "NETWORK_DEFAULT", "SUPPORTED_TYPES", "ClearSignContextType", "solanaBasicFlowRuleInputCodec", "Codec", "array", "string", "optional", "SolanaBasicFlowRuleContextLoader", "dataSource", "loggerFactory", "input", "expectedTypes", "error", "loaded", "rule", "programIds", "network", "resolvedNetwork", "distinctProgramIds", "results", "programId", "programs", "failures", "either", "SolanaProgramNotFoundError", "program", "failure", "Left", "rules", "id", "Right", "builders", "basicFlowTags", "discriminator", "role", "bytes", "hexaStringToBuffer", "builder", "discriminators", "toMatchers", "__decorateClass", "injectable", "__decorateParam", "inject", "instructionInfoTypes", "configTypes", "byProgram"]
+}