@intent-engine/solver 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

package/dist/src/build.d.ts

@@ -0,0 +1,46 @@
+import { type Address, type Base64EncodedWireTransaction, type Blockhash, type Instruction, type TransactionSigner } from "@solana/kit";
+import type { Plan } from "./plan.js";
+export declare const COMPUTE_BUDGET_ADDRESS: Address;
+export declare const MAX_COMPUTE_UNITS = 1400000;
+export declare function computeUnitLimit(units: number): Instruction;
+export declare const UNIT_HEADROOM_DIVISOR = 10n;
+export declare const UNIT_HEADROOM_FLOOR = 1000n;
+export declare function headroom(consumed: bigint): number;
+export declare const MAX_MICRO_LAMPORTS: bigint;
+export declare function computeUnitPrice(microLamports: bigint): Instruction;
+export type Tip = {
+    account: Address;
+    lamports: bigint;
+};
+export type FillContext = {
+    solver: TransactionSigner;
+    feeRecipient: Address;
+    inputTokenProgram: Address;
+    outputTokenProgram: Address;
+    computeUnits: number;
+    unitPrice: bigint;
+    createSolverInput: boolean;
+    createSolverOutput: boolean;
+    tip: Tip | null;
+};
+export declare function payoutAccounts(plan: Pick<Plan, "intent" | "fees">, feeRecipient: Address, inputTokenProgram: Address): Promise<{
+    name: string;
+    address: Address;
+}[]>;
+export declare function fillInstructions(plan: Plan, ctx: FillContext): Promise<Instruction[]>;
+export declare function lookupTablesOf(plan: Plan, own?: readonly Address[]): Address[];
+export declare const TOKEN_PROGRAMS: Address[];
+export declare function solverTableAccounts(solver: Address, feeRecipient: Address, mints: readonly {
+    mint: Address;
+    tokenProgram: Address;
+}[]): Promise<Address[]>;
+export declare const PACKET_DATA_SIZE = 1232;
+export declare const MAX_TX_ACCOUNTS = 64;
+export declare function accountsOf(instructions: readonly Instruction[], payer: Address): number;
+export declare const locksFit: (accounts: number) => boolean;
+export declare const bytesFit: (bytes: number) => boolean;
+export declare function wireSize(wire: Base64EncodedWireTransaction): number;
+export declare function compile(instructions: readonly Instruction[], payer: TransactionSigner, latest: {
+    blockhash: Blockhash;
+    lastValidBlockHeight: bigint;
+}, tables: Readonly<Record<Address, Address[]>>): Promise<Base64EncodedWireTransaction>;

package/dist/src/build.js

@@ -0,0 +1,139 @@
+import { appendTransactionMessageInstructions, getBase64Encoder, compressTransactionMessageUsingAddressLookupTables, createTransactionMessage, getBase64EncodedWireTransaction, pipe, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, signTransactionMessageWithSigners, } from "@solana/kit";
+import { getTransferSolInstruction } from "@solana-program/system";
+import { getCreateAssociatedTokenIdempotentInstructionAsync } from "@solana-program/token";
+import { buildFlashFill, findAssociatedTokenAddress, findConfigPda, findEventAuthorityPda, INSTRUCTIONS_SYSVAR_ADDRESS, } from "@intent-engine/core";
+import { JITO_TIP_ACCOUNTS } from "./jito.js";
+export const COMPUTE_BUDGET_ADDRESS = "ComputeBudget111111111111111111111111111111";
+export const MAX_COMPUTE_UNITS = 1_400_000;
+export function computeUnitLimit(units) {
+    if (!Number.isInteger(units) || units < 1 || units > MAX_COMPUTE_UNITS) {
+        throw new RangeError(`a compute unit limit must be 1 to ${MAX_COMPUTE_UNITS}, got ${units}`);
+    }
+    const data = new Uint8Array(5);
+    data[0] = 2;
+    new DataView(data.buffer).setUint32(1, units, true);
+    return { programAddress: COMPUTE_BUDGET_ADDRESS, data };
+}
+export const UNIT_HEADROOM_DIVISOR = 10n;
+export const UNIT_HEADROOM_FLOOR = 1000n;
+export function headroom(consumed) {
+    const padded = consumed + consumed / UNIT_HEADROOM_DIVISOR + UNIT_HEADROOM_FLOOR;
+    return Math.min(Number(padded), MAX_COMPUTE_UNITS);
+}
+export const MAX_MICRO_LAMPORTS = (1n << 64n) - 1n;
+export function computeUnitPrice(microLamports) {
+    if (microLamports < 0n || microLamports > MAX_MICRO_LAMPORTS) {
+        throw new RangeError(`a compute unit price must be 0 to ${MAX_MICRO_LAMPORTS} micro-lamports, got ${microLamports}`);
+    }
+    const data = new Uint8Array(9);
+    data[0] = 3;
+    new DataView(data.buffer).setBigUint64(1, microLamports, true);
+    return { programAddress: COMPUTE_BUDGET_ADDRESS, data };
+}
+export async function payoutAccounts(plan, feeRecipient, inputTokenProgram) {
+    const intent = plan.intent;
+    const owners = [
+        ...(plan.fees.protocol > 0n ? [{ name: "fee", owner: feeRecipient }] : []),
+        ...(plan.fees.partner > 0n ? [{ name: "partner", owner: intent.partner }] : []),
+        ...(intent.agentFee > 0n ? [{ name: "agent", owner: intent.rentPayer }] : []),
+    ];
+    return Promise.all(owners.map(async ({ name, owner }) => ({
+        name,
+        address: await findAssociatedTokenAddress({ owner, mint: intent.inputMint, tokenProgram: inputTokenProgram }),
+    })));
+}
+export async function fillInstructions(plan, ctx) {
+    const intent = plan.intent;
+    const owner = ctx.solver.address;
+    const solverInput = await findAssociatedTokenAddress({
+        owner,
+        mint: intent.inputMint,
+        tokenProgram: ctx.inputTokenProgram,
+    });
+    const solverOutput = await findAssociatedTokenAddress({
+        owner,
+        mint: intent.outputMint,
+        tokenProgram: ctx.outputTokenProgram,
+    });
+    const flash = await buildFlashFill({
+        solver: ctx.solver,
+        owner: intent.owner,
+        nonce: intent.nonce,
+        inputMint: intent.inputMint,
+        outputMint: intent.outputMint,
+        inputTokenProgram: ctx.inputTokenProgram,
+        outputTokenProgram: ctx.outputTokenProgram,
+        receiver: intent.receiver,
+        solverInput,
+        solverOutput,
+        ...(plan.fees.protocol > 0n ? { feeRecipient: ctx.feeRecipient } : {}),
+        ...(plan.fees.partner > 0n ? { partner: intent.partner } : {}),
+        mandate: intent.mandate,
+        ...(intent.agentFee > 0n ? { agent: intent.rentPayer } : {}),
+        amountIn: plan.amountIn,
+        amountOut: plan.required,
+        maxFeeBps: plan.feeBps + intent.partnerBps,
+        prefix: [
+            computeUnitLimit(ctx.computeUnits),
+            ...(ctx.unitPrice > 0n ? [computeUnitPrice(ctx.unitPrice)] : []),
+            ...(ctx.createSolverInput
+                ? [
+                    await getCreateAssociatedTokenIdempotentInstructionAsync({
+                        payer: ctx.solver,
+                        owner,
+                        mint: intent.inputMint,
+                        tokenProgram: ctx.inputTokenProgram,
+                    }),
+                ]
+                : []),
+            ...(ctx.createSolverOutput
+                ? [
+                    await getCreateAssociatedTokenIdempotentInstructionAsync({
+                        payer: ctx.solver,
+                        owner,
+                        mint: intent.outputMint,
+                        tokenProgram: ctx.outputTokenProgram,
+                    }),
+                ]
+                : []),
+        ],
+        route: [...plan.route.instructions, ...(plan.arbitrage?.instructions ?? [])],
+    });
+    const tip = ctx.tip === null
+        ? []
+        : [getTransferSolInstruction({ source: ctx.solver, destination: ctx.tip.account, amount: ctx.tip.lamports })];
+    return [...flash, ...tip];
+}
+export function lookupTablesOf(plan, own = []) {
+    return [...new Set([...own, ...plan.route.lookupTables, ...(plan.arbitrage?.lookupTables ?? [])])];
+}
+export const TOKEN_PROGRAMS = [
+    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+    "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
+];
+export async function solverTableAccounts(solver, feeRecipient, mints) {
+    const [config] = await findConfigPda();
+    const [events] = await findEventAuthorityPda();
+    const owned = [];
+    for (const { mint, tokenProgram } of mints) {
+        for (const owner of [feeRecipient, solver]) {
+            owned.push(await findAssociatedTokenAddress({ owner, mint, tokenProgram }));
+        }
+    }
+    return [...new Set([config, events, INSTRUCTIONS_SYSVAR_ADDRESS, ...TOKEN_PROGRAMS, ...JITO_TIP_ACCOUNTS, ...owned])];
+}
+export const PACKET_DATA_SIZE = 1_232;
+export const MAX_TX_ACCOUNTS = 64;
+export function accountsOf(instructions, payer) {
+    return new Set([payer, ...instructions.flatMap((ix) => [ix.programAddress, ...(ix.accounts ?? []).map((m) => m.address)])]).size;
+}
+export const locksFit = (accounts) => accounts <= MAX_TX_ACCOUNTS;
+export const bytesFit = (bytes) => bytes <= PACKET_DATA_SIZE;
+export function wireSize(wire) {
+    return getBase64Encoder().encode(wire).length;
+}
+export async function compile(instructions, payer, latest, tables) {
+    const message = pipe(createTransactionMessage({ version: 0 }), (m) => setTransactionMessageFeePayerSigner(payer, m), (m) => setTransactionMessageLifetimeUsingBlockhash(latest, m), (m) => appendTransactionMessageInstructions(instructions, m), (m) => compressTransactionMessageUsingAddressLookupTables(m, tables));
+    return getBase64EncodedWireTransaction(await signTransactionMessageWithSigners(message));
+}
+//# sourceMappingURL=build.js.map

package/dist/src/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/build.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./build.js";
+export * from "./issue.js";
+export * from "./jito.js";
+export * from "./jupiter.js";
+export * from "./lookup.js";
+export * from "./market.js";
+export * from "./plan.js";
+export * from "./solver.js";

package/dist/src/index.js

@@ -0,0 +1,9 @@
+export * from "./build.js";
+export * from "./issue.js";
+export * from "./jito.js";
+export * from "./jupiter.js";
+export * from "./lookup.js";
+export * from "./market.js";
+export * from "./plan.js";
+export * from "./solver.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/src/issue.d.ts

@@ -0,0 +1,12 @@
+import { type Address, type Instruction } from "@solana/kit";
+import type { Pricer } from "./market.js";
+export type IssueRoute = {
+    inputMint: Address;
+    outputMint: Address;
+    outputTokenProgram: Address;
+    out: bigint;
+    in: bigint;
+};
+export declare const MINT_TO = 7;
+export declare function issueInstruction(mint: Address, token: Address, authority: Address, tokenProgram: Address, amount: bigint): Instruction;
+export declare function issuePricer(routes: readonly IssueRoute[]): Pricer;

package/dist/src/issue.js

@@ -0,0 +1,45 @@
+import { AccountRole, getU64Encoder } from "@solana/kit";
+import { findAssociatedTokenAddress } from "@intent-engine/core";
+export const MINT_TO = 7;
+export function issueInstruction(mint, token, authority, tokenProgram, amount) {
+    const data = new Uint8Array(9);
+    data[0] = MINT_TO;
+    data.set(getU64Encoder().encode(amount), 1);
+    return {
+        programAddress: tokenProgram,
+        accounts: [
+            { address: mint, role: AccountRole.WRITABLE },
+            { address: token, role: AccountRole.WRITABLE },
+            { address: authority, role: AccountRole.READONLY_SIGNER },
+        ],
+        data,
+    };
+}
+export function issuePricer(routes) {
+    for (const route of routes) {
+        if (route.out <= 0n || route.in <= 0n) {
+            throw new RangeError(`the issue rate for ${route.outputMint} must be positive on both sides`);
+        }
+    }
+    return {
+        async quote(request) {
+            const route = routes.find((r) => r.inputMint === request.inputMint && r.outputMint === request.outputMint);
+            if (route === undefined) {
+                return null;
+            }
+            const amountOut = (request.amountIn * route.out) / route.in;
+            const token = await findAssociatedTokenAddress({
+                owner: request.taker,
+                mint: route.outputMint,
+                tokenProgram: route.outputTokenProgram,
+            });
+            return {
+                amountIn: request.amountIn,
+                amountOut,
+                instructions: [issueInstruction(route.outputMint, token, request.taker, route.outputTokenProgram, amountOut)],
+                lookupTables: [],
+            };
+        },
+    };
+}
+//# sourceMappingURL=issue.js.map

package/dist/src/issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../src/issue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,aAAa,EAAoB,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAWjE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AAEzB,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,KAAc,EAAE,SAAkB,EAAE,YAAqB,EAAE,MAAc;IACvH,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAClB,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,OAAO;QACL,cAAc,EAAE,YAAY;QAC5B,QAAQ,EAAE;YACR,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC7C,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC9C,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,eAAe,EAAE;SAC1D;QACD,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAA6B;IACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,sBAAsB,KAAK,CAAC,UAAU,iCAAiC,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,OAAqB;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3G,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC;gBAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,KAAK,CAAC,UAAU;gBACtB,YAAY,EAAE,KAAK,CAAC,kBAAkB;aACvC,CAAC,CAAC;YACH,OAAO;gBACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,SAAS;gBACT,YAAY,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;gBAC7G,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/jito.d.ts

@@ -0,0 +1,9 @@
+import type { Address, Base64EncodedWireTransaction } from "@solana/kit";
+import type { Fetch } from "./market.js";
+export declare const JITO_TIP_ACCOUNTS: Address[];
+export declare const MAX_BUNDLE = 5;
+export declare function tipAccount(entropy: number): Address;
+export declare function jitoBundles(options: {
+    url: string;
+    fetch: Fetch;
+}): (wires: readonly Base64EncodedWireTransaction[]) => Promise<string>;

package/dist/src/jito.js

@@ -0,0 +1,43 @@
+export const JITO_TIP_ACCOUNTS = [
+    "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+    "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+    "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+    "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+    "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+    "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+    "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+    "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT",
+];
+export const MAX_BUNDLE = 5;
+export function tipAccount(entropy) {
+    if (!Number.isInteger(entropy) || entropy < 0) {
+        throw new RangeError(`tip entropy must be a non-negative integer, got ${entropy}`);
+    }
+    const account = JITO_TIP_ACCOUNTS[entropy % JITO_TIP_ACCOUNTS.length];
+    if (account === undefined) {
+        throw new RangeError("no tip account");
+    }
+    return account;
+}
+export function jitoBundles(options) {
+    return async (wires) => {
+        if (wires.length < 1 || wires.length > MAX_BUNDLE) {
+            throw new RangeError(`a bundle holds 1 to ${MAX_BUNDLE} transactions, got ${wires.length}`);
+        }
+        const response = await options.fetch(`${options.url}/api/v1/bundles`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "sendBundle", params: [wires, { encoding: "base64" }] }),
+        });
+        if (!response.ok) {
+            throw new Error(`jito rejected the bundle with status ${response.status}`);
+        }
+        const reply = (await response.json());
+        if (typeof reply.result === "string") {
+            return reply.result;
+        }
+        const message = typeof reply.error?.message === "string" ? reply.error.message : "no bundle id returned";
+        throw new Error(`jito rejected the bundle: ${message}`);
+    };
+}
+//# sourceMappingURL=jito.js.map

package/dist/src/jito.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jito.js","sourceRoot":"","sources":["../../src/jito.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;IAC9C,8CAA8C;CAClC,CAAC;AAEf,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsC;IAChE,OAAO,KAAK,EAAE,KAA8C,EAAmB,EAAE;QAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,UAAU,CAAC,uBAAuB,UAAU,sBAAsB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,iBAAiB,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SAC/G,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwD,CAAC;QAC7F,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/jupiter.d.ts

@@ -0,0 +1,20 @@
+import { type Address } from "@solana/kit";
+import type { Fetch, Pricer } from "./market.js";
+export type JupiterOptions = {
+    baseUrl: string;
+    fetch: Fetch;
+    slippageBps: number;
+    maxAccounts: number;
+    swapPrograms?: ReadonlySet<Address>;
+    apiKey?: string;
+};
+export declare const RATE_LIMITED = 429;
+export declare class RateLimited extends Error {
+    constructor();
+}
+export declare const JUPITER_PROGRAM: Address<"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4">;
+export declare const ASSOCIATED_TOKEN_PROGRAM: Address<"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL">;
+export declare const SETUP_PROGRAMS: ReadonlySet<Address>;
+export declare const ATA_CREATE = 0;
+export declare const ATA_CREATE_IDEMPOTENT = 1;
+export declare function jupiterPricer(options: JupiterOptions): Pricer;

package/dist/src/jupiter.js

@@ -0,0 +1,156 @@
+import { AccountRole, address, getBase64Encoder } from "@solana/kit";
+export const RATE_LIMITED = 429;
+export class RateLimited extends Error {
+    constructor() {
+        super("the aggregator is rate limiting this solver; try again on the next run");
+        this.name = "RateLimited";
+    }
+}
+export const JUPITER_PROGRAM = address("JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4");
+export const ASSOCIATED_TOKEN_PROGRAM = address("ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL");
+export const SETUP_PROGRAMS = new Set([ASSOCIATED_TOKEN_PROGRAM]);
+function allowed(ix, programs, what) {
+    if (!programs.has(ix.programAddress)) {
+        throw new Error(`jupiter ${what} calls ${ix.programAddress}, which this solver does not sign for`);
+    }
+    return ix;
+}
+export const ATA_CREATE = 0;
+export const ATA_CREATE_IDEMPOTENT = 1;
+const ATA_PAYER = 0;
+const ATA_WALLET = 2;
+const ATA_MINT = 3;
+function ownAccount(ix, request, what) {
+    const data = ix.data ?? new Uint8Array();
+    const kind = data.length === 0 ? ATA_CREATE : data[0];
+    const opens = data.length <= 1 && (kind === ATA_CREATE || kind === ATA_CREATE_IDEMPOTENT);
+    const mint = ix.accounts?.[ATA_MINT]?.address;
+    if (!opens ||
+        ix.accounts?.[ATA_PAYER]?.address !== request.taker ||
+        ix.accounts?.[ATA_WALLET]?.address !== request.taker ||
+        (mint !== request.inputMint && mint !== request.outputMint)) {
+        throw new Error(`jupiter ${what} does more than open this solver's own token account for the traded mints`);
+    }
+    return ix;
+}
+function oncePerMint(setup) {
+    const mints = setup.map((ix) => ix.accounts?.[ATA_MINT]?.address);
+    if (new Set(mints).size !== mints.length) {
+        throw new Error("jupiter setup opens the same token account more than once");
+    }
+    return setup;
+}
+function field(value, name) {
+    if (value === null || typeof value !== "object" || !(name in value)) {
+        throw new Error(`jupiter response is missing ${name}`);
+    }
+    return value[name];
+}
+function text(value, name) {
+    const found = field(value, name);
+    if (typeof found !== "string") {
+        throw new Error(`jupiter response field ${name} is not a string`);
+    }
+    return found;
+}
+function amount(value, name) {
+    const raw = text(value, name);
+    if (!/^\d+$/.test(raw)) {
+        throw new Error(`jupiter response field ${name} is not an amount: ${raw}`);
+    }
+    return BigInt(raw);
+}
+function instruction(value) {
+    const accounts = field(value, "accounts");
+    if (!Array.isArray(accounts)) {
+        throw new Error("jupiter instruction accounts are not a list");
+    }
+    return {
+        programAddress: address(text(value, "programId")),
+        accounts: accounts.map((meta) => {
+            const signer = field(meta, "isSigner") === true;
+            const writable = field(meta, "isWritable") === true;
+            const role = signer
+                ? writable
+                    ? AccountRole.WRITABLE_SIGNER
+                    : AccountRole.READONLY_SIGNER
+                : writable
+                    ? AccountRole.WRITABLE
+                    : AccountRole.READONLY;
+            return { address: address(text(meta, "pubkey")), role };
+        }),
+        data: new Uint8Array(getBase64Encoder().encode(text(value, "data"))),
+    };
+}
+function instructions(value, name) {
+    if (!(value !== null && typeof value === "object" && name in value)) {
+        return [];
+    }
+    const found = value[name];
+    if (found === null || found === undefined) {
+        return [];
+    }
+    return (Array.isArray(found) ? found : [found]).map(instruction);
+}
+async function body(response, what) {
+    if (response.status === RATE_LIMITED) {
+        throw new RateLimited();
+    }
+    if (!response.ok) {
+        throw new Error(`jupiter ${what} failed with status ${response.status}`);
+    }
+    return response.json();
+}
+export function jupiterPricer(options) {
+    return {
+        async quote(request) {
+            const query = new URLSearchParams({
+                inputMint: request.inputMint,
+                outputMint: request.outputMint,
+                amount: request.amountIn.toString(),
+                slippageBps: String(options.slippageBps),
+                maxAccounts: String(request.maxAccounts ?? options.maxAccounts),
+                onlyDirectRoutes: "false",
+            });
+            const keyed = options.apiKey === undefined ? {} : { "x-api-key": options.apiKey };
+            const quoted = await options.fetch(`${options.baseUrl}/quote?${query.toString()}`, { headers: keyed });
+            if (quoted.status === 400 || quoted.status === 404) {
+                return null;
+            }
+            const quote = await body(quoted, "quote");
+            if (amount(quote, "inAmount") !== request.amountIn) {
+                throw new Error("jupiter quoted a different input amount than requested");
+            }
+            const built = await body(await options.fetch(`${options.baseUrl}/swap-instructions`, {
+                method: "POST",
+                headers: { "content-type": "application/json", ...keyed },
+                body: JSON.stringify({
+                    quoteResponse: quote,
+                    userPublicKey: request.taker,
+                    wrapAndUnwrapSol: false,
+                    dynamicComputeUnitLimit: false,
+                }),
+            }), "swap-instructions");
+            const tables = field(built, "addressLookupTableAddresses");
+            if (!Array.isArray(tables)) {
+                throw new Error("jupiter lookup tables are not a list");
+            }
+            return {
+                amountIn: request.amountIn,
+                amountOut: amount(quote, "otherAmountThreshold"),
+                instructions: [
+                    ...oncePerMint(instructions(built, "setupInstructions").map((ix) => ownAccount(allowed(ix, SETUP_PROGRAMS, "setup"), request, "setup"))),
+                    allowed(instruction(field(built, "swapInstruction")), options.swapPrograms ?? new Set([JUPITER_PROGRAM]), "swap"),
+                    ...instructions(built, "cleanupInstruction").map((ix) => ownAccount(allowed(ix, SETUP_PROGRAMS, "cleanup"), request, "cleanup")),
+                ],
+                lookupTables: tables.map((t) => {
+                    if (typeof t !== "string") {
+                        throw new Error("jupiter lookup table is not an address");
+                    }
+                    return address(t);
+                }),
+            };
+        },
+    };
+}
+//# sourceMappingURL=jupiter.js.map

package/dist/src/jupiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jupiter.js","sourceRoot":"","sources":["../../src/jupiter.ts"],"names":[],"mappings":"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"}

package/dist/src/lookup.d.ts

@@ -0,0 +1,3 @@
+import { type Address } from "@solana/kit";
+export declare const LOOKUP_TABLE_HEADER = 56;
+export declare function decodeLookupTable(data: Uint8Array): Address[];

package/dist/src/lookup.js

@@ -0,0 +1,19 @@
+import { getAddressDecoder } from "@solana/kit";
+export const LOOKUP_TABLE_HEADER = 56;
+const LOOKUP_TABLE_TAG = 1;
+export function decodeLookupTable(data) {
+    if (data.length < LOOKUP_TABLE_HEADER || (data.length - LOOKUP_TABLE_HEADER) % 32 !== 0) {
+        throw new Error(`a lookup table of ${data.length} bytes is malformed`);
+    }
+    const tag = new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(0, true);
+    if (tag !== LOOKUP_TABLE_TAG) {
+        throw new Error(`account is not a lookup table (tag ${tag})`);
+    }
+    const decoder = getAddressDecoder();
+    const out = [];
+    for (let at = LOOKUP_TABLE_HEADER; at < data.length; at += 32) {
+        out.push(decoder.decode(data.subarray(at, at + 32)));
+    }
+    return out;
+}
+//# sourceMappingURL=lookup.js.map

package/dist/src/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAmB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,qBAAqB,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,IAAI,EAAE,GAAG,mBAAmB,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/market.d.ts

@@ -0,0 +1,27 @@
+import type { Address, Instruction } from "@solana/kit";
+export type QuoteRequest = {
+    inputMint: Address;
+    outputMint: Address;
+    amountIn: bigint;
+    taker: Address;
+    maxAccounts?: number;
+};
+export type Quote = {
+    amountIn: bigint;
+    amountOut: bigint;
+    instructions: Instruction[];
+    lookupTables: Address[];
+};
+export interface Pricer {
+    quote(request: QuoteRequest): Promise<Quote | null>;
+}
+export type FetchResponse = {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+};
+export type Fetch = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<FetchResponse>;

package/dist/src/market.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=market.js.map

package/dist/src/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../../src/market.ts"],"names":[],"mappings":""}

package/dist/src/plan.d.ts

@@ -0,0 +1,36 @@
+import type { Address } from "@solana/kit";
+import { type Config, type FeeShares, type Intent, type IntentParams } from "@intent-engine/core";
+import type { Pricer, Quote } from "./market.js";
+export type Cycle = (mint: Address, amount: bigint) => Promise<Quote | null>;
+export type Strategy = {
+    minProfit: ReadonlyMap<Address, bigint>;
+    maxFeeBps: number;
+    cycle?: Cycle;
+    routeAccounts?: number;
+};
+export type Payable = (draft: Pick<Plan, "intent" | "fees">) => Promise<string | null>;
+export type Plan = {
+    address: Address;
+    intent: Intent;
+    amountIn: bigint;
+    required: bigint;
+    feeBps: number;
+    fees: FeeShares;
+    route: Quote;
+    arbitrage: Quote | null;
+    profit: bigint;
+};
+export type Decision = {
+    kind: "fill";
+    plan: Plan;
+} | {
+    kind: "skip";
+    reason: string;
+};
+export type Standing = {
+    params: IntentParams;
+    floor: bigint;
+    feeBps: number;
+};
+export declare function standing(intent: Intent, config: Config, now: bigint, strategy: Strategy): Standing | string;
+export declare function decide(address: Address, intent: Intent, config: Config, now: bigint, pricer: Pricer, solver: Address, strategy: Strategy, payable?: Payable): Promise<Decision>;

package/dist/src/plan.js

@@ -0,0 +1,74 @@
+import { decodeParamsLoose, feeBpsFor, INTENT_VERSION, IntentStatus, Kind, kindBit, PAUSE_FILL, remainingOf, requiredOut, splitFees, } from "@intent-engine/core";
+const skip = (reason) => ({ kind: "skip", reason });
+export function standing(intent, config, now, strategy) {
+    if (intent.version !== INTENT_VERSION) {
+        return `unsupported intent version ${intent.version}`;
+    }
+    if (intent.status !== IntentStatus.Open) {
+        return "not open";
+    }
+    if (now >= intent.expiresAt) {
+        return "expired";
+    }
+    if ((config.paused & PAUSE_FILL) !== 0) {
+        return "fills are paused";
+    }
+    const params = decodeParamsLoose(intent.kind, Uint8Array.from(intent.params));
+    if ("unknown" in params) {
+        return `unreadable params: ${params.reason}`;
+    }
+    if ((config.fillDisabledKinds & kindBit(params.kind)) !== 0n) {
+        return "fills of this kind are stopped";
+    }
+    if (params.kind === Kind.AttestedResult) {
+        return "settles only with an attestation";
+    }
+    const floor = strategy.minProfit.get(intent.outputMint);
+    if (floor === undefined) {
+        return `no profit floor is set for ${intent.outputMint}`;
+    }
+    const feeBps = feeBpsFor(config, params.kind);
+    if (feeBps + intent.partnerBps > strategy.maxFeeBps) {
+        return `fees of ${feeBps + intent.partnerBps} bps exceed the bound of ${strategy.maxFeeBps}`;
+    }
+    return { params, floor, feeBps };
+}
+export async function decide(address, intent, config, now, pricer, solver, strategy, payable = async () => null) {
+    const ready = standing(intent, config, now, strategy);
+    if (typeof ready === "string") {
+        return skip(ready);
+    }
+    const { params, floor, feeBps } = ready;
+    const amountIn = remainingOf(intent);
+    const fees = splitFees(amountIn, feeBps, intent.partnerBps, intent.partnerCutBps);
+    const required = requiredOut(params, amountIn, now);
+    const unpayable = await payable({ intent, fees });
+    if (unpayable !== null) {
+        return skip(unpayable);
+    }
+    const route = await pricer.quote({
+        inputMint: intent.inputMint,
+        outputMint: intent.outputMint,
+        amountIn: fees.net,
+        taker: solver,
+        ...(strategy.routeAccounts === undefined ? {} : { maxAccounts: strategy.routeAccounts }),
+    });
+    if (route === null) {
+        return skip("no route");
+    }
+    if (route.amountOut < required) {
+        return skip(`the route pays ${route.amountOut}, less than the ${required} the intent requires`);
+    }
+    const spread = route.amountOut - required;
+    const arbitrage = strategy.cycle !== undefined && spread > 0n ? await strategy.cycle(intent.outputMint, spread) : null;
+    const gain = arbitrage !== null && arbitrage.amountIn <= spread && arbitrage.amountOut > arbitrage.amountIn ? arbitrage : null;
+    const profit = gain === null ? spread : spread - gain.amountIn + gain.amountOut;
+    if (profit < floor) {
+        return skip(`profit ${profit} is below ${floor}`);
+    }
+    return {
+        kind: "fill",
+        plan: { address, intent, amountIn, required, feeBps, fees, route, arbitrage: gain, profit },
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/src/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/plan.ts"],"names":[],"mappings":"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"}

package/dist/src/solver.d.ts

@@ -0,0 +1,66 @@
+import type { Address, Base64EncodedWireTransaction, Blockhash, Instruction, TransactionSigner } from "@solana/kit";
+import { type Config, type Intent } from "@intent-engine/core";
+import { type Tip } from "./build.js";
+import type { Pricer } from "./market.js";
+import { type Strategy } from "./plan.js";
+export type Chain = {
+    config(): Promise<Config>;
+    intents(): Promise<{
+        address: Address;
+        intent: Intent;
+    }[]>;
+    now(): Promise<bigint>;
+    tokenProgram(mint: Address): Promise<Address>;
+    exists(address: Address): Promise<boolean>;
+    lookupTables(addresses: readonly Address[]): Promise<Record<Address, Address[]>>;
+    blockhash(): Promise<{
+        blockhash: Blockhash;
+        lastValidBlockHeight: bigint;
+    }>;
+    tokenAmount(address: Address): Promise<bigint>;
+};
+export type Simulated = {
+    err: string | null;
+    unitsConsumed: bigint | null;
+    balances: readonly (bigint | null)[];
+};
+export type Sent = {
+    signature: string;
+    confirmed: boolean;
+};
+export type SolverOptions = {
+    chain: Chain;
+    pricer: Pricer;
+    solver: TransactionSigner;
+    strategy: Strategy;
+    tip: Tip | null;
+    lookupTables?: readonly Address[];
+    unitPrice(instructions: readonly Instruction[]): Promise<bigint>;
+    simulate(wire: Base64EncodedWireTransaction, watch: readonly Address[]): Promise<Simulated>;
+    send(wire: Base64EncodedWireTransaction): Promise<Sent>;
+};
+export type Report = {
+    filled: {
+        intent: Address;
+        profit: bigint;
+        signature: string;
+    }[];
+    sent: {
+        intent: Address;
+        profit: bigint;
+        signature: string;
+    }[];
+    skipped: {
+        intent: Address;
+        reason: string;
+    }[];
+    failed: {
+        intent: Address;
+        error: string;
+    }[];
+};
+export declare const SIMULATION_REFUSED = "the fill failed in simulation, so it was not sent";
+export declare const BALANCES_REFUSED = "the fill would leave the solver with less of a token than planned, so it was not sent";
+export declare const ROUTE_ACCOUNT_BUDGETS: readonly [40, 30, 20];
+export declare const tooLarge: (bytes: number | null, accounts: number) => string;
+export declare function tick(o: SolverOptions): Promise<Report>;

package/dist/src/solver.js

@@ -0,0 +1,120 @@
+import { findAssociatedTokenAddress } from "@intent-engine/core";
+import { accountsOf, bytesFit, compile, fillInstructions, headroom, locksFit, lookupTablesOf, MAX_COMPUTE_UNITS, MAX_TX_ACCOUNTS, PACKET_DATA_SIZE, payoutAccounts, wireSize, } from "./build.js";
+import { RateLimited } from "./jupiter.js";
+import { decide, standing } from "./plan.js";
+export const SIMULATION_REFUSED = "the fill failed in simulation, so it was not sent";
+export const BALANCES_REFUSED = "the fill would leave the solver with less of a token than planned, so it was not sent";
+export const ROUTE_ACCOUNT_BUDGETS = [40, 30, 20];
+export const tooLarge = (bytes, accounts) => `even the smallest route makes the fill ${bytes === null ? "lock" : `${bytes} bytes with`} ${accounts} accounts; a transaction holds ${PACKET_DATA_SIZE} bytes and ${MAX_TX_ACCOUNTS} accounts`;
+export async function tick(o) {
+    const report = { filled: [], sent: [], skipped: [], failed: [] };
+    const [config, now, intents] = await Promise.all([o.chain.config(), o.chain.now(), o.chain.intents()]);
+    let limited = null;
+    for (const { address, intent } of intents) {
+        if (limited !== null) {
+            report.skipped.push({ intent: address, reason: limited });
+            continue;
+        }
+        const ready = standing(intent, config, now, o.strategy);
+        if (typeof ready === "string") {
+            report.skipped.push({ intent: address, reason: ready });
+            continue;
+        }
+        try {
+            const inputTokenProgram = await o.chain.tokenProgram(intent.inputMint);
+            const payable = async (draft) => {
+                const missing = [];
+                for (const payout of await payoutAccounts(draft, config.feeRecipient, inputTokenProgram)) {
+                    if (!(await o.chain.exists(payout.address))) {
+                        missing.push(payout.name);
+                    }
+                }
+                return missing.length === 0 ? null : `no ${missing.join(" or ")} account to pay into`;
+            };
+            const solverInput = await findAssociatedTokenAddress({
+                owner: o.solver.address,
+                mint: intent.inputMint,
+                tokenProgram: inputTokenProgram,
+            });
+            const outputTokenProgram = await o.chain.tokenProgram(intent.outputMint);
+            const solverOutput = await findAssociatedTokenAddress({
+                owner: o.solver.address,
+                mint: intent.outputMint,
+                tokenProgram: outputTokenProgram,
+            });
+            const draft = {
+                solver: o.solver,
+                feeRecipient: config.feeRecipient,
+                inputTokenProgram,
+                outputTokenProgram,
+                computeUnits: MAX_COMPUTE_UNITS,
+                unitPrice: 0n,
+                createSolverInput: !(await o.chain.exists(solverInput)),
+                createSolverOutput: !(await o.chain.exists(solverOutput)),
+                tip: o.tip,
+            };
+            let fitting = null;
+            let skipped = null;
+            let size = { bytes: null, accounts: 0 };
+            const latest = await o.chain.blockhash();
+            for (const routeAccounts of ROUTE_ACCOUNT_BUDGETS) {
+                const decision = await decide(address, intent, config, now, o.pricer, o.solver.address, { ...o.strategy, routeAccounts }, payable);
+                if (decision.kind === "skip") {
+                    skipped = decision.reason;
+                    break;
+                }
+                const plan = decision.plan;
+                const context = { ...draft, unitPrice: await o.unitPrice(await fillInstructions(plan, draft)) };
+                const instructions = await fillInstructions(plan, context);
+                const accounts = accountsOf(instructions, o.solver.address);
+                if (!locksFit(accounts)) {
+                    size = { bytes: null, accounts };
+                    continue;
+                }
+                const tables = await o.chain.lookupTables(lookupTablesOf(plan, o.lookupTables));
+                const probe = await compile(instructions, o.solver, latest, tables);
+                const bytes = wireSize(probe);
+                size = { bytes, accounts };
+                if (bytesFit(bytes)) {
+                    fitting = { plan, context, tables, probe };
+                    break;
+                }
+            }
+            if (skipped !== null || fitting === null) {
+                report.skipped.push({ intent: address, reason: skipped ?? tooLarge(size.bytes, size.accounts) });
+                continue;
+            }
+            const { plan, context, tables, probe } = fitting;
+            const before = [await o.chain.tokenAmount(solverInput), await o.chain.tokenAmount(solverOutput)];
+            const simulated = await o.simulate(probe, [solverInput, solverOutput]);
+            if (simulated.err !== null) {
+                report.failed.push({ intent: address, error: `${SIMULATION_REFUSED}: ${simulated.err}` });
+                continue;
+            }
+            const [inputAfter, outputAfter] = simulated.balances;
+            const least = [before[0] ?? 0n, (before[1] ?? 0n) + plan.profit];
+            if (inputAfter === null || inputAfter === undefined || outputAfter === null || outputAfter === undefined || inputAfter < (least[0] ?? 0n) || outputAfter < (least[1] ?? 0n)) {
+                report.failed.push({
+                    intent: address,
+                    error: `${BALANCES_REFUSED}: input ${before[0]} to ${inputAfter}, output ${before[1]} to ${outputAfter}, expected at least ${least[0]} and ${least[1]}`,
+                });
+                continue;
+            }
+            const wire = simulated.unitsConsumed === null
+                ? probe
+                : await compile(await fillInstructions(plan, { ...context, computeUnits: headroom(simulated.unitsConsumed) }), o.solver, latest, tables);
+            const sent = await o.send(wire);
+            (sent.confirmed ? report.filled : report.sent).push({ intent: address, profit: plan.profit, signature: sent.signature });
+        }
+        catch (error) {
+            if (error instanceof RateLimited) {
+                limited = error.message;
+                report.skipped.push({ intent: address, reason: limited });
+                continue;
+            }
+            report.failed.push({ intent: address, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=solver.js.map

package/dist/src/solver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver.js","sourceRoot":"","sources":["../../src/solver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@intent-engine/solver",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "A solver that fills intent engine intents at a profit",
+  "license": "Apache-2.0",
+  "type": "module",
+  "files": [
+    "dist/src"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "dependencies": {
+    "@solana-program/system": "0.14.1",
+    "@solana-program/token": "0.16.1",
+    "@solana/kit": "8.4.0",
+    "@intent-engine/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "26.6.4",
+    "fast-check": "4.10.2",
+    "litesvm": "1.5.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --fsModuleCache"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.