@aboutcircles/sdk-pathfinder 0.1.0

package/dist/flowMatrix.d.ts

@@ -0,0 +1,6 @@
+import type { FlowMatrix, TransferStep, Address } from '@aboutcircles/sdk-types';
+/**
+ * Create an ABI‑ready FlowMatrix object from a list of TransferSteps.
+ */
+export declare function createFlowMatrix(from: Address, to: Address, value: bigint, transfers: TransferStep[]): FlowMatrix;
+//# sourceMappingURL=flowMatrix.d.ts.map

package/dist/flowMatrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowMatrix.d.ts","sourceRoot":"","sources":["../src/flowMatrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAgC,MAAM,yBAAyB,CAAC;AAG/G;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,YAAY,EAAE,GACxB,UAAU,CAmEZ"}

package/dist/flowMatrix.js

@@ -0,0 +1,57 @@
+import { packCoordinates, transformToFlowVertices } from './packing';
+/**
+ * Create an ABI‑ready FlowMatrix object from a list of TransferSteps.
+ */
+export function createFlowMatrix(from, to, value, transfers) {
+    const sender = from.toLowerCase();
+    const receiver = to.toLowerCase();
+    const { sorted: flowVertices, idx } = transformToFlowVertices(transfers, sender, receiver);
+    const flowEdges = transfers.map((t) => {
+        const isTerminal = t.to.toLowerCase() === receiver;
+        return {
+            streamSinkId: isTerminal ? 1 : 0,
+            amount: t.value
+        };
+    });
+    // Ensure at least one terminal edge
+    const hasTerminalEdge = flowEdges.some((e) => e.streamSinkId === 1);
+    if (!hasTerminalEdge) {
+        const lastEdgeIndex = transfers
+            .map((t) => t.to.toLowerCase())
+            .lastIndexOf(receiver);
+        const fallbackIndex = lastEdgeIndex === -1 ? flowEdges.length - 1 : lastEdgeIndex;
+        flowEdges[fallbackIndex].streamSinkId = 1;
+    }
+    const termEdgeIds = flowEdges
+        .map((e, i) => (e.streamSinkId === 1 ? i : -1))
+        .filter((i) => i !== -1);
+    const streams = [
+        {
+            sourceCoordinate: idx[sender],
+            flowEdgeIds: termEdgeIds,
+            data: new Uint8Array(0)
+        }
+    ];
+    const coords = [];
+    transfers.forEach((t) => {
+        coords.push(idx[t.tokenOwner.toLowerCase()]);
+        coords.push(idx[t.from.toLowerCase()]);
+        coords.push(idx[t.to.toLowerCase()]);
+    });
+    const packedCoordinates = packCoordinates(coords);
+    const expected = BigInt(value);
+    const terminalSum = flowEdges
+        .filter((e) => e.streamSinkId === 1)
+        .reduce((sum, e) => sum + BigInt(e.amount.toString()), BigInt(0));
+    const isBalanced = terminalSum === expected;
+    if (!isBalanced) {
+        throw new Error(`Terminal sum ${terminalSum} does not equal expected ${expected}`);
+    }
+    return {
+        flowVertices,
+        flowEdges,
+        streams,
+        packedCoordinates,
+        sourceCoordinate: idx[sender]
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './flowMatrix';
+export * from './path';
+export * from './packing';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}