@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/services/rewardsService/rewardsService.js

@@ -0,0 +1,298 @@
+import { getAddress } from "viem";
+const MERKL_DISTRIBUTOR_ABI = [
+    {
+        type: "function",
+        name: "claim",
+        inputs: [
+            { name: "users", type: "address[]", internalType: "address[]" },
+            { name: "tokens", type: "address[]", internalType: "address[]" },
+            { name: "amounts", type: "uint256[]", internalType: "uint256[]" },
+            { name: "proofs", type: "bytes32[][]", internalType: "bytes32[][]" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+];
+const BREVIS_CLAIM_ABI = [
+    {
+        type: "function",
+        name: "claim",
+        inputs: [
+            { name: "earner", type: "address", internalType: "address" },
+            {
+                name: "cumulativeAmounts",
+                type: "uint256[]",
+                internalType: "uint256[]",
+            },
+            { name: "epoch", type: "uint64", internalType: "uint64" },
+            { name: "proof", type: "bytes32[]", internalType: "bytes32[]" },
+        ],
+        outputs: [],
+        stateMutability: "nonpayable",
+    },
+];
+const FUUL_MANAGER_ABI = [
+    {
+        type: "function",
+        name: "claim",
+        inputs: [
+            {
+                name: "claimChecks",
+                type: "tuple[]",
+                internalType: "struct ClaimCheck[]",
+                components: [
+                    { name: "projectAddress", type: "address", internalType: "address" },
+                    { name: "to", type: "address", internalType: "address" },
+                    { name: "currency", type: "address", internalType: "address" },
+                    {
+                        name: "currencyType",
+                        type: "uint8",
+                        internalType: "enum IFuulProject.TokenType",
+                    },
+                    { name: "amount", type: "uint256", internalType: "uint256" },
+                    { name: "reason", type: "uint8", internalType: "enum ClaimReason" },
+                    { name: "tokenId", type: "uint256", internalType: "uint256" },
+                    { name: "deadline", type: "uint256", internalType: "uint256" },
+                    { name: "proof", type: "bytes32", internalType: "bytes32" },
+                    { name: "signatures", type: "bytes[]", internalType: "bytes[]" },
+                ],
+            },
+        ],
+        outputs: [],
+        stateMutability: "payable",
+    },
+];
+const FUUL_FACTORY_ABI = [
+    {
+        type: "function",
+        name: "getFeesInformation",
+        inputs: [
+            { name: "projectAddress", type: "address", internalType: "address" },
+        ],
+        outputs: [
+            {
+                name: "",
+                type: "tuple",
+                internalType: "struct FeesInformation",
+                components: [
+                    {
+                        name: "projectOwnerClaimFee",
+                        type: "uint256",
+                        internalType: "uint256",
+                    },
+                    {
+                        name: "nativeUserClaimFee",
+                        type: "uint256",
+                        internalType: "uint256",
+                    },
+                    {
+                        name: "tokenUserClaimFee",
+                        type: "uint256",
+                        internalType: "uint256",
+                    },
+                ],
+            },
+        ],
+        stateMutability: "view",
+    },
+];
+export class RewardsService {
+    adapter;
+    directAdapter;
+    addresses;
+    providerService;
+    constructor(adapter, directAdapter, addresses) {
+        this.adapter = adapter;
+        this.directAdapter = directAdapter;
+        this.addresses = addresses;
+    }
+    setAdapter(adapter) {
+        this.adapter = adapter;
+    }
+    setProviderService(providerService) {
+        this.providerService = providerService;
+    }
+    async fetchVaultRewards(chainId, vaultAddress) {
+        return this.adapter.fetchVaultRewards(chainId, vaultAddress);
+    }
+    async fetchChainRewards(chainId) {
+        return this.adapter.fetchChainRewards(chainId);
+    }
+    async populateRewards(vaults) {
+        if (vaults.length === 0)
+            return;
+        const byChain = new Map();
+        for (const vault of vaults) {
+            const arr = byChain.get(vault.chainId) ?? [];
+            arr.push(vault);
+            byChain.set(vault.chainId, arr);
+        }
+        await Promise.all(Array.from(byChain.entries()).map(async ([chainId, chainVaults]) => {
+            const rewardsMap = await this.fetchChainRewards(chainId);
+            for (const vault of chainVaults) {
+                vault.rewards = rewardsMap.get(vault.address.toLowerCase());
+                vault.populated.rewards = true;
+            }
+        }));
+    }
+    async fetchUserRewards(chainId, address) {
+        return this.adapter.fetchUserRewards(chainId, address);
+    }
+    async fetchFuulTotals(address) {
+        const adapter = this.directAdapter ?? this.adapter;
+        return adapter.fetchFuulTotals(address);
+    }
+    async fetchFuulClaimChecks(address) {
+        const adapter = this.directAdapter ?? this.adapter;
+        return adapter.fetchFuulClaimChecks(address);
+    }
+    async buildClaimPlan(args) {
+        return this.buildClaimPlans({
+            rewards: [args.reward],
+            account: args.account,
+        });
+    }
+    async buildClaimPlans(args) {
+        const account = getAddress(args.account);
+        const rewards = args.rewards.filter((reward) => BigInt(reward.unclaimed) > 0n);
+        if (rewards.length === 0)
+            return [];
+        const plan = [];
+        const merklRewards = rewards.filter((reward) => reward.provider === "merkl");
+        if (merklRewards.length > 0) {
+            const groupedMerklRewards = new Map();
+            for (const reward of merklRewards) {
+                if (!reward.claimAddress || !reward.proof?.length) {
+                    throw new Error("Missing Merkl claim data");
+                }
+                const key = `${reward.chainId}:${reward.claimAddress.toLowerCase()}`;
+                const group = groupedMerklRewards.get(key) ?? [];
+                group.push(reward);
+                groupedMerklRewards.set(key, group);
+            }
+            for (const group of groupedMerklRewards.values()) {
+                plan.push(this.buildMerklContractCall(group, account));
+            }
+        }
+        for (const reward of rewards) {
+            if (reward.provider !== "brevis")
+                continue;
+            plan.push(this.buildBrevisContractCall(reward, account));
+        }
+        const fuulRewards = rewards.filter((reward) => reward.provider === "fuul");
+        if (fuulRewards.length > 0) {
+            const chainIds = new Set(fuulRewards.map((reward) => reward.chainId));
+            if (chainIds.size > 1) {
+                throw new Error("Fuul claim planning requires rewards from a single chain");
+            }
+            plan.push(await this.buildFuulContractCall(fuulRewards[0].chainId, account));
+        }
+        return plan;
+    }
+    async buildClaimAllPlan(args) {
+        const rewards = await this.fetchUserRewards(args.chainId, args.account);
+        return this.buildClaimPlans({ rewards, account: args.account });
+    }
+    buildMerklContractCall(rewards, account) {
+        const firstReward = rewards[0];
+        if (!firstReward?.claimAddress) {
+            throw new Error("Missing Merkl claim address");
+        }
+        return {
+            type: "contractCall",
+            chainId: firstReward.chainId,
+            to: firstReward.claimAddress,
+            abi: MERKL_DISTRIBUTOR_ABI,
+            functionName: "claim",
+            args: [
+                rewards.map(() => account),
+                rewards.map((reward) => reward.token.address),
+                rewards.map((reward) => BigInt(reward.accumulated)),
+                rewards.map((reward) => reward.proof ?? []),
+            ],
+            value: 0n,
+        };
+    }
+    buildBrevisContractCall(reward, account) {
+        if (!reward.claimAddress ||
+            !reward.cumulativeAmounts?.length ||
+            !reward.epoch ||
+            !reward.proof?.length) {
+            throw new Error("Missing Brevis claim data");
+        }
+        return {
+            type: "contractCall",
+            chainId: reward.chainId,
+            to: reward.claimAddress,
+            abi: BREVIS_CLAIM_ABI,
+            functionName: "claim",
+            args: [
+                account,
+                reward.cumulativeAmounts.map((amount) => BigInt(amount)),
+                BigInt(reward.epoch),
+                reward.proof,
+            ],
+            value: 0n,
+        };
+    }
+    async buildFuulContractCall(chainId, account) {
+        const claimChecks = await this.fetchFuulClaimChecks(account);
+        if (claimChecks.length === 0) {
+            throw new Error("No claimable Fuul rewards found");
+        }
+        const uniqueProjects = [
+            ...new Set(claimChecks.map((check) => getAddress(check.project_address))),
+        ];
+        const feePairs = await Promise.all(uniqueProjects.map(async (projectAddress) => [
+            projectAddress,
+            await this.readFuulClaimFee(chainId, projectAddress),
+        ]));
+        const feeMap = new Map(feePairs);
+        const totalFee = claimChecks.reduce((sum, check) => sum + (feeMap.get(getAddress(check.project_address)) ?? 0n), 0n);
+        return {
+            type: "contractCall",
+            chainId,
+            to: this.addresses.fuulManagerAddress,
+            abi: FUUL_MANAGER_ABI,
+            functionName: "claim",
+            args: [
+                claimChecks.map((check) => ({
+                    projectAddress: getAddress(check.project_address),
+                    to: getAddress(check.to),
+                    currency: getAddress(check.currency),
+                    currencyType: check.currency_type,
+                    amount: BigInt(check.amount),
+                    reason: check.reason,
+                    tokenId: BigInt(check.token_id),
+                    deadline: BigInt(check.deadline),
+                    proof: check.proof,
+                    signatures: check.signatures,
+                })),
+            ],
+            value: totalFee,
+        };
+    }
+    async readFuulClaimFee(chainId, projectAddress) {
+        if (!this.providerService) {
+            throw new Error("RewardsService providerService not configured");
+        }
+        const provider = this.providerService.getProvider(chainId);
+        const feesInfo = await provider.readContract({
+            address: this.addresses.fuulFactoryAddress,
+            abi: FUUL_FACTORY_ABI,
+            functionName: "getFeesInformation",
+            args: [projectAddress],
+        });
+        return feesInfo.nativeUserClaimFee;
+    }
+    getMerklDistributorAddress() {
+        return this.addresses.merklDistributorAddress;
+    }
+    getFuulManagerAddress() {
+        return this.addresses.fuulManagerAddress;
+    }
+    getFuulFactoryAddress() {
+        return this.addresses.fuulFactoryAddress;
+    }
+}
+//# sourceMappingURL=rewardsService.js.map

package/dist/src/services/rewardsService/rewardsService.js.map

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

package/dist/src/services/rewardsService/rewardsServiceTypes.d.ts

@@ -0,0 +1,270 @@
+import type { Address, Hex } from "viem";
+import type { ERC4626Vault } from "../../entities/ERC4626Vault.js";
+import type { TransactionPlan } from "../executionService/index.js";
+export type RewardSource = "merkl" | "brevis" | "fuul";
+export type RewardAction = "LEND" | "BORROW";
+export interface RewardCampaign {
+    campaignId: string;
+    source: RewardSource;
+    action: RewardAction;
+    /** APR as a decimal fraction (0.05 = 5%). */
+    apr: number;
+    rewardTokenAddress?: Address;
+    rewardTokenSymbol: string;
+    dailyRewards?: number;
+    /** Campaign end time in seconds (unix timestamp). */
+    endTimestamp?: number;
+}
+export interface VaultRewardInfo {
+    /** Sum of all LIVE campaign APRs (decimal fraction). */
+    totalRewardsApr: number;
+    campaigns: RewardCampaign[];
+}
+export interface UserRewardToken {
+    address: Address;
+    chainId: number;
+    symbol: string;
+    name: string;
+    decimals: number;
+}
+export interface UserReward {
+    /** Chain the reward can be claimed on (may differ from account chain for cross-chain rewards). */
+    chainId: number;
+    /** Reward token metadata. */
+    token: UserRewardToken;
+    /** USD price per whole token (floating point). */
+    tokenPrice: number;
+    /** Reward provider. */
+    provider: RewardSource;
+    /** Total accumulated reward amount (raw, unscaled bigint as string). */
+    accumulated: string;
+    /** Unclaimed reward amount (raw, unscaled bigint as string). */
+    unclaimed: string;
+    /** Merkle proof for claiming. */
+    proof?: Hex[];
+    /** Contract address to call for claiming rewards. */
+    claimAddress?: Address;
+    /** Cumulative amounts for epoch-based claiming (Brevis). */
+    cumulativeAmounts?: string[];
+    /** Epoch identifier (Brevis). */
+    epoch?: string;
+}
+export interface RewardsDirectAdapterConfig {
+    merklApiUrl?: string;
+    brevisApiUrl?: string;
+    /** URL for Brevis user rewards proofs endpoint. */
+    brevisProofsApiUrl?: string;
+    /** Public Fuul incentives API base URL. */
+    fuulApiUrl?: string;
+    /** Optional app-hosted endpoint for Fuul totals. */
+    fuulTotalsUrl?: string;
+    /** Optional app-hosted endpoint for Fuul claim checks. */
+    fuulClaimChecksUrl?: string;
+    /** Chain IDs for which Brevis campaigns should be fetched (default: [1]). */
+    brevisChainIds?: number[];
+    /** Override the Merkl distributor contract address (default: standard Merkl Distributor). */
+    merklDistributorAddress?: Address;
+    /** Optional Fuul claim manager address for user reward display / future claim flows. */
+    fuulManagerAddress?: Address;
+    /** Override the Fuul factory address used to read per-project claim fees. */
+    fuulFactoryAddress?: Address;
+    /** Feature flags for individual providers. */
+    enableMerkl?: boolean;
+    enableBrevis?: boolean;
+    enableFuul?: boolean;
+}
+export interface RewardsV3AdapterConfig {
+    /** Base HTTP endpoint, for example `https://v3staging.eul.dev`. */
+    endpoint: string;
+    /** Optional API key sent as `X-API-Key` on V3 HTTP requests. */
+    apiKey?: string;
+}
+export interface RewardsServiceConfig {
+    adapter?: "v3" | "direct";
+    merklApiUrl?: string;
+    brevisApiUrl?: string;
+    /** URL for Brevis user rewards proofs endpoint. */
+    brevisProofsApiUrl?: string;
+    /** Public Fuul incentives API base URL. */
+    fuulApiUrl?: string;
+    /** Optional app-hosted endpoint for Fuul totals. */
+    fuulTotalsUrl?: string;
+    /** Optional app-hosted endpoint for Fuul claim checks. */
+    fuulClaimChecksUrl?: string;
+    /** Chain IDs for which Brevis campaigns should be fetched (default: [1]). */
+    brevisChainIds?: number[];
+    /** Override the Merkl distributor contract address (default: standard Merkl Distributor). */
+    merklDistributorAddress?: Address;
+    /** Optional Fuul claim manager address for user reward display / future claim flows. */
+    fuulManagerAddress?: Address;
+    /** Override the Fuul factory address used to read per-project claim fees. */
+    fuulFactoryAddress?: Address;
+    /** Feature flags for individual providers. */
+    enableMerkl?: boolean;
+    enableBrevis?: boolean;
+    enableFuul?: boolean;
+    directAdapterConfig?: RewardsDirectAdapterConfig;
+    v3AdapterConfig?: RewardsV3AdapterConfig;
+}
+export interface BuildRewardClaimPlanArgs {
+    reward: UserReward;
+    account: Address;
+}
+export interface BuildRewardClaimsPlanArgs {
+    rewards: UserReward[];
+    account: Address;
+}
+export interface BuildRewardClaimAllPlanArgs {
+    chainId: number;
+    account: Address;
+}
+export interface IRewardsService {
+    fetchVaultRewards(chainId: number, vaultAddress: Address): Promise<VaultRewardInfo | undefined>;
+    fetchChainRewards(chainId: number): Promise<Map<string, VaultRewardInfo>>;
+    populateRewards(vaults: ERC4626Vault[]): Promise<void>;
+    fetchUserRewards(chainId: number, address: Address): Promise<UserReward[]>;
+    fetchFuulTotals(address: Address): Promise<FuulTotals>;
+    fetchFuulClaimChecks(address: Address): Promise<FuulClaimCheck[]>;
+    buildClaimPlan(args: BuildRewardClaimPlanArgs): Promise<TransactionPlan>;
+    buildClaimPlans(args: BuildRewardClaimsPlanArgs): Promise<TransactionPlan>;
+    buildClaimAllPlan(args: BuildRewardClaimAllPlanArgs): Promise<TransactionPlan>;
+}
+export interface IRewardsAdapter {
+    fetchVaultRewards(chainId: number, vaultAddress: Address): Promise<VaultRewardInfo | undefined>;
+    fetchChainRewards(chainId: number): Promise<Map<string, VaultRewardInfo>>;
+    fetchUserRewards(chainId: number, address: Address): Promise<UserReward[]>;
+    fetchFuulTotals(address: Address): Promise<FuulTotals>;
+    fetchFuulClaimChecks(address: Address): Promise<FuulClaimCheck[]>;
+}
+export interface MerklCampaign {
+    id: string;
+    campaignId: string;
+    type: string;
+    rewardToken: {
+        address: string;
+        symbol: string;
+    };
+    apr: number;
+    dailyRewards: number;
+    startTimestamp: number;
+    endTimestamp: number;
+}
+export interface MerklOpportunity {
+    chainId: number;
+    type: string;
+    identifier: string;
+    status: "LIVE" | "PAST";
+    action: "LEND" | "BORROW";
+    apr: number;
+    dailyRewards: number;
+    campaigns: MerklCampaign[];
+}
+export interface BrevisRewardInfo {
+    token_address: string;
+    token_symbol: string;
+    apr: number;
+    rewardUsdPrice?: number;
+}
+export interface BrevisCampaign {
+    chain_id: number;
+    vault_address: string;
+    action: number;
+    campaign_id: string;
+    campaign_name: string;
+    start_time: number;
+    end_time: number;
+    reward_info: BrevisRewardInfo;
+    status: number;
+}
+export interface BrevisCampaignsRequest {
+    chain_id?: number[];
+    action?: number[];
+    status?: number[];
+}
+export interface BrevisCampaignsResponse {
+    err?: {
+        code: number;
+        msg: string;
+    };
+    campaigns: BrevisCampaign[];
+}
+export interface MerklUserRewardEntry {
+    token: {
+        address: string;
+        chainId: number;
+        price: number;
+        symbol: string;
+        name: string;
+        decimals: number;
+        icon?: string;
+        isTest?: boolean;
+    };
+    amount: string;
+    claimed: string;
+    proofs: string[];
+}
+export interface MerklUserChainRewards {
+    chainId: number;
+    rewards: MerklUserRewardEntry[];
+}
+export interface BrevisUserRewardBatchEntry {
+    campaignId: string;
+    claimChainId: number;
+    claimContractAddr: string;
+    claimableRewards: string;
+    epoch: string;
+    cumulativeRewards: string[];
+    merkleProof: string[];
+}
+export interface BrevisUserRewardsBatchResponse {
+    err?: {
+        code: string;
+        msg: string;
+    } | null;
+    rewardsBatch: BrevisUserRewardBatchEntry[] | null;
+}
+export interface FuulPool {
+    name: string;
+    token0_symbol: string;
+    token0_address: string;
+}
+export interface FuulTrigger {
+    type: string;
+    context: {
+        chain_id: number;
+        token_address: string;
+    };
+}
+export interface FuulIncentive {
+    conversion: string;
+    project: string;
+    protocol: string;
+    chain_id: number;
+    pool: FuulPool;
+    trigger: FuulTrigger;
+    apr: number;
+    tvl: number;
+    refreshed_at: string;
+}
+export interface FuulClaimCheck {
+    project_address: string;
+    to: string;
+    currency: string;
+    currency_type: number;
+    amount: string;
+    reason: number;
+    token_id: string;
+    deadline: string;
+    proof: string;
+    signatures: string[];
+}
+export interface FuulTotalEntry {
+    currency: string;
+    currency_type: number;
+    amount: string;
+    chain_id: number;
+}
+export interface FuulTotals {
+    claimed: FuulTotalEntry[];
+    unclaimed: FuulTotalEntry[];
+}

package/dist/src/services/rewardsService/rewardsServiceTypes.js

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

package/dist/src/services/rewardsService/rewardsServiceTypes.js.map

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

package/dist/src/services/simulationService/index.d.ts

@@ -0,0 +1,2 @@
+export { SimulationService, type ISimulationService, } from "./simulationService.js";
+export type { SimulateBatchResult, SimulateBatchOptions, SimulationStateOverrideOptions, SimulationInsufficientRequirement, } from "./simulationService.js";

package/dist/src/services/simulationService/index.js

@@ -0,0 +1,2 @@
+export { SimulationService, } from "./simulationService.js";
+//# sourceMappingURL=index.js.map

package/dist/src/services/simulationService/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/simulationService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,GAEjB,MAAM,wBAAwB,CAAC"}