@ember-finance/sdk 2.22.0 → 2.23.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 (37) hide show
  1. package/dist/src/abis/CcipRouter.json +58 -0
  2. package/dist/src/abis/index.d.ts +3 -1
  3. package/dist/src/abis/index.js +4 -1
  4. package/dist/src/api/v2/apis/accounts-api.d.ts +2 -0
  5. package/dist/src/api/v2/apis/accounts-api.js +3 -1
  6. package/dist/src/api/v2/models/account-transaction-transaction-data.d.ts +2 -1
  7. package/dist/src/api/v2/models/account-transaction.d.ts +2 -0
  8. package/dist/src/api/v2/models/account-transaction.js +3 -1
  9. package/dist/src/api/v2/models/bridge-transaction.d.ts +50 -0
  10. package/dist/src/api/v2/models/bridge-transaction.js +14 -0
  11. package/dist/src/api/v2/models/chain.d.ts +6 -0
  12. package/dist/src/api/v2/models/evm-ccip-lane.d.ts +73 -0
  13. package/dist/src/api/v2/models/evm-ccip-lane.js +14 -0
  14. package/dist/src/api/v2/models/evm-ccip-rate-limits.d.ts +36 -0
  15. package/dist/src/api/v2/models/evm-ccip-rate-limits.js +14 -0
  16. package/dist/src/api/v2/models/evm-ccip-token-pool.d.ts +122 -0
  17. package/dist/src/api/v2/models/evm-ccip-token-pool.js +17 -0
  18. package/dist/src/api/v2/models/evm-contracts.d.ts +9 -0
  19. package/dist/src/api/v2/models/evm-oftadapter.d.ts +11 -0
  20. package/dist/src/api/v2/models/evm-oftadapter.js +4 -1
  21. package/dist/src/api/v2/models/evm-oftpeer.d.ts +12 -0
  22. package/dist/src/api/v2/models/index.d.ts +4 -0
  23. package/dist/src/api/v2/models/index.js +4 -0
  24. package/dist/src/evm-vaults/interfaces/index.d.ts +39 -0
  25. package/dist/src/evm-vaults/on-chain-calls/tx-builder.d.ts +15 -1
  26. package/dist/src/evm-vaults/on-chain-calls/tx-builder.js +36 -0
  27. package/dist/src/evm-vaults/on-chain-calls/user.d.ts +40 -1
  28. package/dist/src/evm-vaults/on-chain-calls/user.js +75 -0
  29. package/dist/src/evm-vaults/on-chain-calls/vault-reader.d.ts +14 -1
  30. package/dist/src/evm-vaults/on-chain-calls/vault-reader.js +30 -0
  31. package/dist/src/evm-vaults/utils/ccip.d.ts +23 -0
  32. package/dist/src/evm-vaults/utils/ccip.js +32 -0
  33. package/dist/src/evm-vaults/utils/deployment-parser.d.ts +46 -1
  34. package/dist/src/evm-vaults/utils/deployment-parser.js +74 -0
  35. package/dist/src/evm-vaults/utils/index.d.ts +1 -0
  36. package/dist/src/evm-vaults/utils/index.js +1 -0
  37. package/package.json +1 -1
@@ -0,0 +1,58 @@
1
+ {
2
+ "abi": [
3
+ {
4
+ "type": "function",
5
+ "name": "getFee",
6
+ "stateMutability": "view",
7
+ "inputs": [
8
+ { "name": "destChainSelector", "type": "uint64" },
9
+ {
10
+ "name": "message",
11
+ "type": "tuple",
12
+ "components": [
13
+ { "name": "receiver", "type": "bytes" },
14
+ { "name": "data", "type": "bytes" },
15
+ {
16
+ "name": "tokenAmounts",
17
+ "type": "tuple[]",
18
+ "components": [
19
+ { "name": "token", "type": "address" },
20
+ { "name": "amount", "type": "uint256" }
21
+ ]
22
+ },
23
+ { "name": "feeToken", "type": "address" },
24
+ { "name": "extraArgs", "type": "bytes" }
25
+ ]
26
+ }
27
+ ],
28
+ "outputs": [{ "name": "fee", "type": "uint256" }]
29
+ },
30
+ {
31
+ "type": "function",
32
+ "name": "ccipSend",
33
+ "stateMutability": "payable",
34
+ "inputs": [
35
+ { "name": "destinationChainSelector", "type": "uint64" },
36
+ {
37
+ "name": "message",
38
+ "type": "tuple",
39
+ "components": [
40
+ { "name": "receiver", "type": "bytes" },
41
+ { "name": "data", "type": "bytes" },
42
+ {
43
+ "name": "tokenAmounts",
44
+ "type": "tuple[]",
45
+ "components": [
46
+ { "name": "token", "type": "address" },
47
+ { "name": "amount", "type": "uint256" }
48
+ ]
49
+ },
50
+ { "name": "feeToken", "type": "address" },
51
+ { "name": "extraArgs", "type": "bytes" }
52
+ ]
53
+ }
54
+ ],
55
+ "outputs": [{ "name": "messageId", "type": "bytes32" }]
56
+ }
57
+ ]
58
+ }
@@ -3,6 +3,7 @@ import EmberProtocolConfigABI from "./EmberProtocolConfig.json";
3
3
  import ERC20TokenABI from "./ERC20Token.json";
4
4
  import EmberVaultOFTAdapterABI from "./EmberVaultMintBurnOFTAdapter.json";
5
5
  import OpenCoverVaultABI from "./OpenCoverVault.json";
6
+ import CcipRouterABI from "./CcipRouter.json";
6
7
  import { Interface } from "ethers";
7
8
  declare const EmberVault: Interface;
8
9
  declare const EmberProtocolConfig: Interface;
@@ -10,4 +11,5 @@ declare const ERC20Token: Interface;
10
11
  declare const EmberETHVault: Interface;
11
12
  declare const EmberVaultOFTAdapter: Interface;
12
13
  declare const OpenCoverVault: Interface;
13
- export { EmberVaultABI, EmberProtocolConfigABI, ERC20TokenABI, EmberVault, EmberProtocolConfig, ERC20Token, EmberETHVault, EmberVaultOFTAdapterABI, EmberVaultOFTAdapter, OpenCoverVaultABI, OpenCoverVault };
14
+ declare const CcipRouter: Interface;
15
+ export { EmberVaultABI, EmberProtocolConfigABI, ERC20TokenABI, EmberVault, EmberProtocolConfig, ERC20Token, EmberETHVault, EmberVaultOFTAdapterABI, EmberVaultOFTAdapter, OpenCoverVaultABI, OpenCoverVault, CcipRouterABI, CcipRouter };
@@ -4,6 +4,7 @@ import ERC20TokenABI from "./ERC20Token.json" with { type: "json" };
4
4
  import EmberETHVaultABI from "./EmberETHVault.json" with { type: "json" };
5
5
  import EmberVaultOFTAdapterABI from "./EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
6
6
  import OpenCoverVaultABI from "./OpenCoverVault.json" with { type: "json" };
7
+ import CcipRouterABI from "./CcipRouter.json" with { type: "json" };
7
8
  import { Interface } from "ethers";
8
9
  const EmberVault = new Interface(EmberVaultABI.abi);
9
10
  const EmberProtocolConfig = new Interface(EmberProtocolConfigABI.abi);
@@ -11,4 +12,6 @@ const ERC20Token = new Interface(ERC20TokenABI.abi);
11
12
  const EmberETHVault = new Interface(EmberETHVaultABI.abi);
12
13
  const EmberVaultOFTAdapter = new Interface(EmberVaultOFTAdapterABI.abi);
13
14
  const OpenCoverVault = new Interface(OpenCoverVaultABI.abi);
14
- export { EmberVaultABI, EmberProtocolConfigABI, ERC20TokenABI, EmberVault, EmberProtocolConfig, ERC20Token, EmberETHVault, EmberVaultOFTAdapterABI, EmberVaultOFTAdapter, OpenCoverVaultABI, OpenCoverVault };
15
+ // Chainlink's Router, trimmed to what a bridge send needs: quote, then send.
16
+ const CcipRouter = new Interface(CcipRouterABI.abi);
17
+ export { EmberVaultABI, EmberProtocolConfigABI, ERC20TokenABI, EmberVault, EmberProtocolConfig, ERC20Token, EmberETHVault, EmberVaultOFTAdapterABI, EmberVaultOFTAdapter, OpenCoverVaultABI, OpenCoverVault, CcipRouterABI, CcipRouter };
@@ -508,6 +508,8 @@ export declare const GetAccountHistoryTypeEnum: {
508
508
  readonly InstantWithdrawSwapHoldbackRelease: "InstantWithdrawSwapHoldbackRelease";
509
509
  readonly HoldbackClaimed: "HoldbackClaimed";
510
510
  readonly WithdrawalClaimed: "WithdrawalClaimed";
511
+ readonly BridgeIn: "BridgeIn";
512
+ readonly BridgeOut: "BridgeOut";
511
513
  };
512
514
  export type GetAccountHistoryTypeEnum = (typeof GetAccountHistoryTypeEnum)[keyof typeof GetAccountHistoryTypeEnum];
513
515
  /**
@@ -961,7 +961,9 @@ export const GetAccountHistoryTypeEnum = {
961
961
  InstantWithdrawViaSwap: "InstantWithdrawViaSwap",
962
962
  InstantWithdrawSwapHoldbackRelease: "InstantWithdrawSwapHoldbackRelease",
963
963
  HoldbackClaimed: "HoldbackClaimed",
964
- WithdrawalClaimed: "WithdrawalClaimed"
964
+ WithdrawalClaimed: "WithdrawalClaimed",
965
+ BridgeIn: "BridgeIn",
966
+ BridgeOut: "BridgeOut"
965
967
  };
966
968
  /**
967
969
  * @export
@@ -9,6 +9,7 @@
9
9
  * https://openapi-generator.tech
10
10
  * Do not edit the class manually.
11
11
  */
12
+ import type { BridgeTransaction } from "./bridge-transaction.js";
12
13
  import type { DepositTransaction } from "./deposit-transaction.js";
13
14
  import type { EscrowClaimTransaction } from "./escrow-claim-transaction.js";
14
15
  import type { HoldbackReleaseTransaction } from "./holdback-release-transaction.js";
@@ -24,4 +25,4 @@ import type { RedeemRequestTransaction } from "./redeem-request-transaction.js";
24
25
  * The data of the transaction
25
26
  * @export
26
27
  */
27
- export type AccountTransactionTransactionData = DepositTransaction | EscrowClaimTransaction | HoldbackReleaseTransaction | InstantWithdrawTransaction | InstantWithdrawViaSwapTransaction | ParkingLotDepositTransaction | RedeemRequestCancelledTransaction | RedeemRequestProcessedTransaction | RedeemRequestSkippedTransaction | RedeemRequestTransaction;
28
+ export type AccountTransactionTransactionData = BridgeTransaction | DepositTransaction | EscrowClaimTransaction | HoldbackReleaseTransaction | InstantWithdrawTransaction | InstantWithdrawViaSwapTransaction | ParkingLotDepositTransaction | RedeemRequestCancelledTransaction | RedeemRequestProcessedTransaction | RedeemRequestSkippedTransaction | RedeemRequestTransaction;
@@ -51,5 +51,7 @@ export declare const AccountTransactionTransactionTypeEnum: {
51
51
  readonly InstantWithdrawSwapHoldbackRelease: "InstantWithdrawSwapHoldbackRelease";
52
52
  readonly HoldbackClaimed: "HoldbackClaimed";
53
53
  readonly WithdrawalClaimed: "WithdrawalClaimed";
54
+ readonly BridgeIn: "BridgeIn";
55
+ readonly BridgeOut: "BridgeOut";
54
56
  };
55
57
  export type AccountTransactionTransactionTypeEnum = (typeof AccountTransactionTransactionTypeEnum)[keyof typeof AccountTransactionTransactionTypeEnum];
@@ -26,5 +26,7 @@ export const AccountTransactionTransactionTypeEnum = {
26
26
  InstantWithdrawViaSwap: "InstantWithdrawViaSwap",
27
27
  InstantWithdrawSwapHoldbackRelease: "InstantWithdrawSwapHoldbackRelease",
28
28
  HoldbackClaimed: "HoldbackClaimed",
29
- WithdrawalClaimed: "WithdrawalClaimed"
29
+ WithdrawalClaimed: "WithdrawalClaimed",
30
+ BridgeIn: "BridgeIn",
31
+ BridgeOut: "BridgeOut"
30
32
  };
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Ember Protocol Vaults API
3
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
4
+ *
5
+ * The version of the OpenAPI document: 2.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { Asset } from "./asset.js";
13
+ import type { VaultSlice } from "./vault-slice.js";
14
+ /**
15
+ * Vault shares moving between chains. BridgeOut burns them on the origin chain, BridgeIn mints them on the destination; the two are separate transactions on separate chains rather than one record, because each chain reports its own half. Carries no transport discriminator: a vault has exactly one bridge, so which one carried a given transfer is a property of the vault rather than of the transaction. Read it from the vault\'s own bridge config.
16
+ * @export
17
+ * @interface BridgeTransaction
18
+ */
19
+ export interface BridgeTransaction {
20
+ /**
21
+ * The timestamp of the event
22
+ * @type {number}
23
+ * @memberof BridgeTransaction
24
+ */
25
+ timestamp?: number;
26
+ /**
27
+ * The amount of shares bridged
28
+ * @type {string}
29
+ * @memberof BridgeTransaction
30
+ */
31
+ sharesAmount?: string;
32
+ /**
33
+ *
34
+ * @type {Asset}
35
+ * @memberof BridgeTransaction
36
+ */
37
+ sharesCoin?: Asset;
38
+ /**
39
+ *
40
+ * @type {VaultSlice}
41
+ * @memberof BridgeTransaction
42
+ */
43
+ vault?: VaultSlice;
44
+ /**
45
+ * The transaction hash on this chain
46
+ * @type {string}
47
+ * @memberof BridgeTransaction
48
+ */
49
+ txDigest?: string;
50
+ }
@@ -0,0 +1,14 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Ember Protocol Vaults API
5
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
6
+ *
7
+ * The version of the OpenAPI document: 2.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export {};
@@ -63,6 +63,12 @@ export interface Chain {
63
63
  * @memberof Chain
64
64
  */
65
65
  lzChainId?: number;
66
+ /**
67
+ * The Chainlink CCIP chain selector. A string because the value is a 64-bit integer. Null for a chain CCIP does not reach.
68
+ * @type {string}
69
+ * @memberof Chain
70
+ */
71
+ ccipChainSelector?: string;
66
72
  /**
67
73
  * Whether the chain supports AML checks
68
74
  * @type {boolean}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Ember Protocol Vaults API
3
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
4
+ *
5
+ * The version of the OpenAPI document: 2.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { EvmCcipRateLimits } from "./evm-ccip-rate-limits.js";
13
+ /**
14
+ * One configured destination. remoteNetwork and remoteAddress mean the same as on an OFT peer; the rest has no LayerZero equivalent.
15
+ * @export
16
+ * @interface EvmCcipLane
17
+ */
18
+ export interface EvmCcipLane {
19
+ /**
20
+ * The remote chain\'s network name, e.g. atlantic. The map key is a CCIP chain selector, so read this instead.
21
+ * @type {string}
22
+ * @memberof EvmCcipLane
23
+ */
24
+ remoteNetwork?: string;
25
+ /**
26
+ * The bridge contract at the far end, as a plain address. Same meaning as remoteAddress on an OFT peer.
27
+ * @type {string}
28
+ * @memberof EvmCcipLane
29
+ */
30
+ remoteAddress?: string;
31
+ /**
32
+ * The remote chain\'s CCIP selector, carried as a string because it is 64-bit
33
+ * @type {string}
34
+ * @memberof EvmCcipLane
35
+ */
36
+ remoteChainSelector?: string;
37
+ /**
38
+ * The remote CCIP token pool address
39
+ * @type {string}
40
+ * @memberof EvmCcipLane
41
+ */
42
+ remotePool?: string;
43
+ /**
44
+ * The remote receipt token address
45
+ * @type {string}
46
+ * @memberof EvmCcipLane
47
+ */
48
+ remoteToken?: string;
49
+ /**
50
+ *
51
+ * @type {EvmCcipRateLimits}
52
+ * @memberof EvmCcipLane
53
+ */
54
+ rateLimits?: EvmCcipRateLimits;
55
+ /**
56
+ * The timestamp when the lane was configured
57
+ * @type {string}
58
+ * @memberof EvmCcipLane
59
+ */
60
+ configuredAt?: string;
61
+ /**
62
+ * The transaction hash of the lane configuration
63
+ * @type {string}
64
+ * @memberof EvmCcipLane
65
+ */
66
+ txHash?: string;
67
+ /**
68
+ * The block number of the lane configuration
69
+ * @type {number}
70
+ * @memberof EvmCcipLane
71
+ */
72
+ blockNumber?: number;
73
+ }
@@ -0,0 +1,14 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Ember Protocol Vaults API
5
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
6
+ *
7
+ * The version of the OpenAPI document: 2.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export {};
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Ember Protocol Vaults API
3
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
4
+ *
5
+ * The version of the OpenAPI document: 2.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ * Per-lane outbound rate limiting. Has no LayerZero equivalent, so it is deliberately not flattened into a shared shape.
14
+ * @export
15
+ * @interface EvmCcipRateLimits
16
+ */
17
+ export interface EvmCcipRateLimits {
18
+ /**
19
+ * Whether rate limiting is enforced on this lane
20
+ * @type {boolean}
21
+ * @memberof EvmCcipRateLimits
22
+ */
23
+ enabled?: boolean;
24
+ /**
25
+ * Token bucket capacity, in receipt token base units
26
+ * @type {string}
27
+ * @memberof EvmCcipRateLimits
28
+ */
29
+ capacity?: string;
30
+ /**
31
+ * Refill rate, in receipt token base units per second
32
+ * @type {string}
33
+ * @memberof EvmCcipRateLimits
34
+ */
35
+ rate?: string;
36
+ }
@@ -0,0 +1,14 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Ember Protocol Vaults API
5
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
6
+ *
7
+ * The version of the OpenAPI document: 2.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export {};
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Ember Protocol Vaults API
3
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
4
+ *
5
+ * The version of the OpenAPI document: 2.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { EvmCcipLane } from "./evm-ccip-lane.js";
13
+ /**
14
+ * The CCIP half of a vault\'s bridge, the counterpart to EvmOFTAdapter. A vault has one active transport; different vaults use different ones.
15
+ * @export
16
+ * @interface EvmCcipTokenPool
17
+ */
18
+ export interface EvmCcipTokenPool {
19
+ /**
20
+ * The CCIP token pool contract address
21
+ * @type {string}
22
+ * @memberof EvmCcipTokenPool
23
+ */
24
+ address?: string;
25
+ /**
26
+ * The contract name (e.g., EmberTokenPool)
27
+ * @type {string}
28
+ * @memberof EvmCcipTokenPool
29
+ */
30
+ contractName?: string;
31
+ /**
32
+ * Which bridge this entry describes. Read this rather than inferring the transport from which map the entry was found in.
33
+ * @type {string}
34
+ * @memberof EvmCcipTokenPool
35
+ */
36
+ bridgeTransport?: EvmCcipTokenPoolBridgeTransportEnum;
37
+ /**
38
+ * The pool\'s on-chain typeAndVersion (e.g., EmberBurnMintTokenPool 1.0.0)
39
+ * @type {string}
40
+ * @memberof EvmCcipTokenPool
41
+ */
42
+ typeAndVersion?: string;
43
+ /**
44
+ * The key of the associated vault
45
+ * @type {string}
46
+ * @memberof EvmCcipTokenPool
47
+ */
48
+ vaultKey?: string;
49
+ /**
50
+ * The address of the associated vault
51
+ * @type {string}
52
+ * @memberof EvmCcipTokenPool
53
+ */
54
+ vaultAddress?: string;
55
+ /**
56
+ * The receipt token symbol
57
+ * @type {string}
58
+ * @memberof EvmCcipTokenPool
59
+ */
60
+ receiptTokenSymbol?: string;
61
+ /**
62
+ * The receipt token decimals
63
+ * @type {number}
64
+ * @memberof EvmCcipTokenPool
65
+ */
66
+ decimals?: number;
67
+ /**
68
+ * The CCIP Router for this chain
69
+ * @type {string}
70
+ * @memberof EvmCcipTokenPool
71
+ */
72
+ router?: string;
73
+ /**
74
+ * The CCIP RMN proxy for this chain
75
+ * @type {string}
76
+ * @memberof EvmCcipTokenPool
77
+ */
78
+ rmnProxy?: string;
79
+ /**
80
+ * The CCIP token admin registry for this chain
81
+ * @type {string}
82
+ * @memberof EvmCcipTokenPool
83
+ */
84
+ tokenAdminRegistry?: string;
85
+ /**
86
+ * This chain\'s CCIP selector. A 64-bit value, carried as a string because it exceeds what a JSON number holds exactly.
87
+ * @type {string}
88
+ * @memberof EvmCcipTokenPool
89
+ */
90
+ chainSelector?: string;
91
+ /**
92
+ * The owner address
93
+ * @type {string}
94
+ * @memberof EvmCcipTokenPool
95
+ */
96
+ owner?: string;
97
+ /**
98
+ * The deployment timestamp
99
+ * @type {string}
100
+ * @memberof EvmCcipTokenPool
101
+ */
102
+ deployedAt?: string;
103
+ /**
104
+ * The block number at which the pool was deployed
105
+ * @type {number}
106
+ * @memberof EvmCcipTokenPool
107
+ */
108
+ deploymentBlockNumber?: number;
109
+ /**
110
+ * Map of configured destinations by remote CCIP chain selector
111
+ * @type {{ [key: string]: EvmCcipLane; }}
112
+ * @memberof EvmCcipTokenPool
113
+ */
114
+ lanes?: {
115
+ [key: string]: EvmCcipLane;
116
+ };
117
+ }
118
+ export declare const EvmCcipTokenPoolBridgeTransportEnum: {
119
+ readonly LayerZero: "LayerZero";
120
+ readonly Ccip: "CCIP";
121
+ };
122
+ export type EvmCcipTokenPoolBridgeTransportEnum = (typeof EvmCcipTokenPoolBridgeTransportEnum)[keyof typeof EvmCcipTokenPoolBridgeTransportEnum];
@@ -0,0 +1,17 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Ember Protocol Vaults API
5
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
6
+ *
7
+ * The version of the OpenAPI document: 2.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export const EvmCcipTokenPoolBridgeTransportEnum = {
15
+ LayerZero: "LayerZero",
16
+ Ccip: "CCIP"
17
+ };
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import type { EvmAtomicLiquidityLib } from "./evm-atomic-liquidity-lib.js";
13
13
  import type { EvmAtomicVault } from "./evm-atomic-vault.js";
14
+ import type { EvmCcipTokenPool } from "./evm-ccip-token-pool.js";
14
15
  import type { EvmDepositParkingLot } from "./evm-deposit-parking-lot.js";
15
16
  import type { EvmDepositToken } from "./evm-deposit-token.js";
16
17
  import type { EvmOFTAdapter } from "./evm-oftadapter.js";
@@ -80,6 +81,14 @@ export interface EvmContracts {
80
81
  oftAdapters?: {
81
82
  [key: string]: EvmOFTAdapter;
82
83
  };
84
+ /**
85
+ * Map of CCIP token pools by name
86
+ * @type {{ [key: string]: EvmCcipTokenPool; }}
87
+ * @memberof EvmContracts
88
+ */
89
+ ccipTokenPools?: {
90
+ [key: string]: EvmCcipTokenPool;
91
+ };
83
92
  /**
84
93
  *
85
94
  * @type {EvmVaultValidator}
@@ -82,6 +82,12 @@ export interface EvmOFTAdapter {
82
82
  * @memberof EvmOFTAdapter
83
83
  */
84
84
  deploymentBlockNumber?: number;
85
+ /**
86
+ * Which bridge this entry describes. Read this rather than inferring the transport from which map the entry was found in.
87
+ * @type {string}
88
+ * @memberof EvmOFTAdapter
89
+ */
90
+ bridgeTransport?: EvmOFTAdapterBridgeTransportEnum;
85
91
  /**
86
92
  * Map of peers by LayerZero endpoint ID
87
93
  * @type {{ [key: string]: EvmOFTPeer; }}
@@ -91,3 +97,8 @@ export interface EvmOFTAdapter {
91
97
  [key: string]: EvmOFTPeer;
92
98
  };
93
99
  }
100
+ export declare const EvmOFTAdapterBridgeTransportEnum: {
101
+ readonly LayerZero: "LayerZero";
102
+ readonly Ccip: "CCIP";
103
+ };
104
+ export type EvmOFTAdapterBridgeTransportEnum = (typeof EvmOFTAdapterBridgeTransportEnum)[keyof typeof EvmOFTAdapterBridgeTransportEnum];
@@ -11,4 +11,7 @@
11
11
  * https://openapi-generator.tech
12
12
  * Do not edit the class manually.
13
13
  */
14
- export {};
14
+ export const EvmOFTAdapterBridgeTransportEnum = {
15
+ LayerZero: "LayerZero",
16
+ Ccip: "CCIP"
17
+ };
@@ -15,6 +15,18 @@
15
15
  * @interface EvmOFTPeer
16
16
  */
17
17
  export interface EvmOFTPeer {
18
+ /**
19
+ * The remote chain\'s network name, e.g. atlantic. The map key is a LayerZero endpoint ID, which names nothing outside LayerZero, so read this instead.
20
+ * @type {string}
21
+ * @memberof EvmOFTPeer
22
+ */
23
+ remoteNetwork?: string;
24
+ /**
25
+ * The bridge contract at the far end, as a plain address. Same meaning as remoteAddress on a CCIP lane.
26
+ * @type {string}
27
+ * @memberof EvmOFTPeer
28
+ */
29
+ remoteAddress?: string;
18
30
  /**
19
31
  * The peer address in bytes32 format
20
32
  * @type {string}
@@ -14,6 +14,7 @@ export * from "./apy-period-average.js";
14
14
  export * from "./asset.js";
15
15
  export * from "./atomic-vault-info.js";
16
16
  export * from "./borrowed.js";
17
+ export * from "./bridge-transaction.js";
17
18
  export * from "./chain.js";
18
19
  export * from "./chain-vault-details.js";
19
20
  export * from "./coin-placement.js";
@@ -25,6 +26,9 @@ export * from "./ember-position.js";
25
26
  export * from "./escrow-claim-transaction.js";
26
27
  export * from "./evm-atomic-liquidity-lib.js";
27
28
  export * from "./evm-atomic-vault.js";
29
+ export * from "./evm-ccip-lane.js";
30
+ export * from "./evm-ccip-rate-limits.js";
31
+ export * from "./evm-ccip-token-pool.js";
28
32
  export * from "./evm-contracts.js";
29
33
  export * from "./evm-deposit-parking-lot.js";
30
34
  export * from "./evm-deposit-token.js";
@@ -14,6 +14,7 @@ export * from "./apy-period-average.js";
14
14
  export * from "./asset.js";
15
15
  export * from "./atomic-vault-info.js";
16
16
  export * from "./borrowed.js";
17
+ export * from "./bridge-transaction.js";
17
18
  export * from "./chain.js";
18
19
  export * from "./chain-vault-details.js";
19
20
  export * from "./coin-placement.js";
@@ -25,6 +26,9 @@ export * from "./ember-position.js";
25
26
  export * from "./escrow-claim-transaction.js";
26
27
  export * from "./evm-atomic-liquidity-lib.js";
27
28
  export * from "./evm-atomic-vault.js";
29
+ export * from "./evm-ccip-lane.js";
30
+ export * from "./evm-ccip-rate-limits.js";
31
+ export * from "./evm-ccip-token-pool.js";
28
32
  export * from "./evm-contracts.js";
29
33
  export * from "./evm-deposit-parking-lot.js";
30
34
  export * from "./evm-deposit-token.js";
@@ -242,6 +242,45 @@ export interface ICoverVaultCallOptions extends IUserCallOptions {
242
242
  /**
243
243
  * Optional parameters for high-level OFT bridge send calls.
244
244
  */
245
+ /**
246
+ * Parameters for a CCIP bridge send.
247
+ *
248
+ * Deliberately shaped like IOFTSendParam so the two transports read the same
249
+ * way, but CCIP names a destination by chain selector rather than endpoint id,
250
+ * and takes the receiver as a plain address — the SDK encodes it.
251
+ */
252
+ export interface ICcipSendParam {
253
+ /** CCIP chain selector of the destination. A 64-bit value, so a string. */
254
+ destinationChainSelector: string;
255
+ /** Recipient address on the destination chain */
256
+ receiver: string;
257
+ /** Amount to send in local token decimals */
258
+ amount: bigint;
259
+ /** Fee token; omit to pay in the chain's native currency */
260
+ feeToken?: string;
261
+ /** Destination execution gas. 0 for a plain token transfer. */
262
+ destinationGasLimit?: bigint;
263
+ }
264
+ /**
265
+ * A CCIP fee quote.
266
+ *
267
+ * CCIP charges one fee, unlike LayerZero's native/LZ token split, and does not
268
+ * quote the received amount separately: a burn-and-mint pool mints exactly what
269
+ * was burned, so the amount received is the amount sent.
270
+ */
271
+ export interface ICcipFeeQuote {
272
+ /** Fee required to send, in feeToken units (wei when paying natively) */
273
+ fee: bigint;
274
+ /** Token the fee is charged in; the zero address means native currency */
275
+ feeToken: string;
276
+ }
277
+ /** Overrides for a CCIP bridge send. */
278
+ export interface ICcipBridgeSendOptions extends IEvmCallOptions {
279
+ /** Fee token; omit to pay in the chain's native currency */
280
+ feeToken?: string;
281
+ /** Destination execution gas. 0 for a plain token transfer. */
282
+ destinationGasLimit?: bigint;
283
+ }
245
284
  export interface IBridgeSendOptions extends IEvmCallOptions {
246
285
  /** Minimum amount to receive on destination; defaults to amount */
247
286
  minAmount?: bigint;
@@ -1,5 +1,5 @@
1
1
  import { EVMDeploymentParser } from "../utils/index.js";
2
- import { EvmProtocolInfo, VaultPauseOperation, ITransactionCall, IPermitSignature, IOFTSendParam, IOFTMessagingFee } from "../interfaces/index.js";
2
+ import { EvmProtocolInfo, VaultPauseOperation, ITransactionCall, IPermitSignature, IOFTSendParam, IOFTMessagingFee, ICcipSendParam } from "../interfaces/index.js";
3
3
  import { NumStr } from "../../common/types.js";
4
4
  /**
5
5
  * EVM Transaction Builder for Ember Protocol (ERC-4626 Compatible)
@@ -543,6 +543,20 @@ export declare class EVMTxBuilder {
543
543
  * @returns Transaction call object
544
544
  */
545
545
  bridgeSend(adapterAddress: string, sendParam: IOFTSendParam, fee: IOFTMessagingFee, refundAddress: string): ITransactionCall;
546
+ /**
547
+ * Builds the CCIP send call.
548
+ *
549
+ * The counterpart to bridgeSend, but the call goes to Chainlink's Router
550
+ * rather than to our own pool: the Router pulls the tokens, charges the fee
551
+ * and hands off to the pool. That is also why the approval for a CCIP bridge
552
+ * goes to the Router and not to the pool.
553
+ *
554
+ * @param routerAddress The CCIP Router on the source chain
555
+ * @param sendParam Destination, receiver and amount
556
+ * @param tokenAddress The receipt token being bridged
557
+ * @param fee Fee from getCcipFeeQuote, sent as value when paying natively
558
+ */
559
+ ccipSend(routerAddress: string, sendParam: ICcipSendParam, tokenAddress: string, fee: bigint): ITransactionCall;
546
560
  private atomicCall;
547
561
  /** Claim the caller's own escrowed (deferred) holdback collateral. */
548
562
  atomicClaimHoldback(vaultAddress: string): ITransactionCall;
@@ -4,6 +4,8 @@ import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json"
4
4
  import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
5
5
  import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
6
6
  import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
7
+ import CcipRouterABI from "../../abis/CcipRouter.json" with { type: "json" };
8
+ import { ZERO_ADDRESS, encodeCcipReceiver, encodeCcipExtraArgs } from "../utils/ccip.js";
7
9
  import AtomicLiquidityABI from "../../abis/AtomicLiquidity.json" with { type: "json" };
8
10
  import EmberDepositParkingLotABI from "../../abis/EmberDepositParkingLot.json" with { type: "json" };
9
11
  import OpenCoverVaultABI from "../../abis/OpenCoverVault.json" with { type: "json" };
@@ -1147,6 +1149,40 @@ export class EVMTxBuilder {
1147
1149
  chainId: this.getChainId()
1148
1150
  };
1149
1151
  }
1152
+ /**
1153
+ * Builds the CCIP send call.
1154
+ *
1155
+ * The counterpart to bridgeSend, but the call goes to Chainlink's Router
1156
+ * rather than to our own pool: the Router pulls the tokens, charges the fee
1157
+ * and hands off to the pool. That is also why the approval for a CCIP bridge
1158
+ * goes to the Router and not to the pool.
1159
+ *
1160
+ * @param routerAddress The CCIP Router on the source chain
1161
+ * @param sendParam Destination, receiver and amount
1162
+ * @param tokenAddress The receipt token being bridged
1163
+ * @param fee Fee from getCcipFeeQuote, sent as value when paying natively
1164
+ */
1165
+ ccipSend(routerAddress, sendParam, tokenAddress, fee) {
1166
+ const feeToken = sendParam.feeToken ?? ZERO_ADDRESS;
1167
+ return {
1168
+ to: routerAddress,
1169
+ functionName: "ccipSend",
1170
+ args: [
1171
+ sendParam.destinationChainSelector,
1172
+ {
1173
+ receiver: encodeCcipReceiver(sendParam.receiver),
1174
+ data: "0x",
1175
+ tokenAmounts: [{ token: tokenAddress, amount: sendParam.amount }],
1176
+ feeToken,
1177
+ extraArgs: encodeCcipExtraArgs(sendParam.destinationGasLimit)
1178
+ }
1179
+ ],
1180
+ abi: CcipRouterABI.abi,
1181
+ // Paying in a token means the Router pulls it instead, so no value.
1182
+ value: feeToken === ZERO_ADDRESS ? fee : 0n,
1183
+ chainId: this.getChainId()
1184
+ };
1185
+ }
1150
1186
  // ============================================
1151
1187
  // Atomic Liquidity Vault methods (BFE-817/818)
1152
1188
  //
@@ -1,6 +1,6 @@
1
1
  import { Signer, Provider } from "ethers";
2
2
  import { EVMOnChainCalls } from "./onchain-calls.js";
3
- import { EvmProtocolInfo, IUserCallOptions, IEvmCallOptions, ICoverVaultCallOptions, EvmOnChainCallResponse, IPermitSignature, IETHDepositOptions, IBridgeSendOptions, IOFTFeeQuote } from "../interfaces/index.js";
3
+ import { EvmProtocolInfo, IUserCallOptions, IEvmCallOptions, ICoverVaultCallOptions, EvmOnChainCallResponse, IPermitSignature, IETHDepositOptions, IBridgeSendOptions, IOFTFeeQuote, ICcipFeeQuote, ICcipBridgeSendOptions } from "../interfaces/index.js";
4
4
  import { NumStr } from "../../common/types.js";
5
5
  import { Chain } from "../../api/v2/index.js";
6
6
  /**
@@ -423,6 +423,45 @@ export declare class EVMUserCalls extends EVMOnChainCalls {
423
423
  * @returns Transaction execution response
424
424
  */
425
425
  bridgeSendToken(destinationChain: Chain, tokenAddress: string, amount: NumStr, receiver: string, feeQuote: IOFTFeeQuote, options?: IBridgeSendOptions): Promise<EvmOnChainCallResponse>;
426
+ /**
427
+ * Bridges a receipt token to a destination chain using the vault's CCIP pool.
428
+ *
429
+ * The counterpart to bridgeSendToken. Call getBridgeTransportForVault first
430
+ * and pick the matching method — a vault has exactly one active bridge, and
431
+ * calling the wrong one throws rather than silently doing nothing.
432
+ *
433
+ * One difference from the LayerZero path worth knowing: the allowance goes
434
+ * to the CCIP Router, not to the pool, because the Router is what pulls the
435
+ * tokens. An unconfigured route throws here rather than reverting on chain.
436
+ *
437
+ * @param destinationChain Destination chain metadata (must include ccipChainSelector)
438
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
439
+ * @param amount Amount to bridge in local token decimals
440
+ * @param receiver Recipient wallet address on the destination chain
441
+ * @param feeQuote Fee quote returned by reader.getCcipFeeQuote
442
+ * @param options Optional bridge/send overrides
443
+ * @returns Transaction execution response
444
+ */
445
+ bridgeSendTokenViaCcip(destinationChain: Chain, tokenAddress: string, amount: NumStr, receiver: string, feeQuote: ICcipFeeQuote, options?: ICcipBridgeSendOptions): Promise<EvmOnChainCallResponse>;
446
+ /**
447
+ * Reports which bridge a vault uses, or undefined if it has none.
448
+ *
449
+ * A vault has exactly one active bridge, but different vaults use different
450
+ * ones, so branch on this rather than assuming either transport.
451
+ *
452
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
453
+ */
454
+ getBridgeTransportForVault(tokenAddress: string): "LayerZero" | "CCIP" | undefined;
455
+ /**
456
+ * Lists the networks a vault can bridge to, whichever transport it uses.
457
+ *
458
+ * Empty for a vault with no bridge, and for a bridged vault with no route
459
+ * configured yet. A network absent from this list cannot be sent to — the
460
+ * send would revert on chain — so drive the destination picker from it.
461
+ *
462
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
463
+ */
464
+ getBridgeDestinationsForVault(tokenAddress: string): string[];
426
465
  /**
427
466
  * Gets the vault contract instance for read operations
428
467
  * @param vaultAddress The address of the vault
@@ -637,6 +637,81 @@ export class EVMUserCalls extends EVMOnChainCalls {
637
637
  }, refundAddress);
638
638
  return this.execCall(txCall, options);
639
639
  }
640
+ /**
641
+ * Bridges a receipt token to a destination chain using the vault's CCIP pool.
642
+ *
643
+ * The counterpart to bridgeSendToken. Call getBridgeTransportForVault first
644
+ * and pick the matching method — a vault has exactly one active bridge, and
645
+ * calling the wrong one throws rather than silently doing nothing.
646
+ *
647
+ * One difference from the LayerZero path worth knowing: the allowance goes
648
+ * to the CCIP Router, not to the pool, because the Router is what pulls the
649
+ * tokens. An unconfigured route throws here rather than reverting on chain.
650
+ *
651
+ * @param destinationChain Destination chain metadata (must include ccipChainSelector)
652
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
653
+ * @param amount Amount to bridge in local token decimals
654
+ * @param receiver Recipient wallet address on the destination chain
655
+ * @param feeQuote Fee quote returned by reader.getCcipFeeQuote
656
+ * @param options Optional bridge/send overrides
657
+ * @returns Transaction execution response
658
+ */
659
+ async bridgeSendTokenViaCcip(destinationChain, tokenAddress, amount, receiver, feeQuote, options) {
660
+ if (!this.provider) {
661
+ throw new Error("Provider required for bridge send read operations and allowance checks");
662
+ }
663
+ const pool = this.parser.getCcipTokenPoolByVaultAddress(tokenAddress);
664
+ if (!pool?.router) {
665
+ throw new Error(`CCIP token pool not found for token address: ${tokenAddress}`);
666
+ }
667
+ if (destinationChain.ccipChainSelector === undefined ||
668
+ destinationChain.ccipChainSelector === null) {
669
+ throw new Error(`Destination chain "${destinationChain.name ?? destinationChain.identifier}" has no ccipChainSelector — cannot address a CCIP destination`);
670
+ }
671
+ const remoteChainSelector = destinationChain.ccipChainSelector;
672
+ const lane = this.parser.getCcipLaneByVaultAndSelector(tokenAddress, remoteChainSelector);
673
+ if (!lane) {
674
+ throw new Error(`No CCIP lane configured from this chain to "${destinationChain.identifier}" for token ${tokenAddress}`);
675
+ }
676
+ const amountBigInt = BigInt(amount);
677
+ // The Router moves the tokens, so it is the Router that needs approval.
678
+ const token = new ethers.Contract(tokenAddress, ["function allowance(address,address) view returns (uint256)"], this.provider);
679
+ const currentAllowance = await token.allowance(await this.getWalletAddress(), pool.router);
680
+ if (currentAllowance < amountBigInt) {
681
+ throw new Error(`Insufficient allowance for bridge transfer. Current allowance: ${currentAllowance}, required: ${amountBigInt}`);
682
+ }
683
+ const txCall = this.txBuilder.ccipSend(pool.router, {
684
+ destinationChainSelector: remoteChainSelector,
685
+ receiver,
686
+ amount: amountBigInt,
687
+ feeToken: options?.feeToken,
688
+ destinationGasLimit: options?.destinationGasLimit
689
+ }, tokenAddress, feeQuote.fee);
690
+ return this.execCall(txCall, options);
691
+ }
692
+ /**
693
+ * Reports which bridge a vault uses, or undefined if it has none.
694
+ *
695
+ * A vault has exactly one active bridge, but different vaults use different
696
+ * ones, so branch on this rather than assuming either transport.
697
+ *
698
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
699
+ */
700
+ getBridgeTransportForVault(tokenAddress) {
701
+ return this.parser.getBridgeTransportByVaultAddress(tokenAddress);
702
+ }
703
+ /**
704
+ * Lists the networks a vault can bridge to, whichever transport it uses.
705
+ *
706
+ * Empty for a vault with no bridge, and for a bridged vault with no route
707
+ * configured yet. A network absent from this list cannot be sent to — the
708
+ * send would revert on chain — so drive the destination picker from it.
709
+ *
710
+ * @param tokenAddress Receipt token address (also the vault identifier in EVM deployment data)
711
+ */
712
+ getBridgeDestinationsForVault(tokenAddress) {
713
+ return this.parser.getBridgeDestinationsByVaultAddress(tokenAddress);
714
+ }
640
715
  // ============================================
641
716
  // Read-Only Methods
642
717
  // ============================================
@@ -1,6 +1,6 @@
1
1
  import { Provider } from "ethers";
2
2
  import { EVMDeploymentParser } from "../utils/deployment-parser.js";
3
- import { EvmProtocolInfo, IOFTSendParam, IOFTFeeQuote, IOFTVaultSupportedChain, IParkingLotInfo } from "../interfaces/index.js";
3
+ import { EvmProtocolInfo, IOFTSendParam, IOFTFeeQuote, IOFTVaultSupportedChain, IParkingLotInfo, ICcipSendParam, ICcipFeeQuote } from "../interfaces/index.js";
4
4
  import { NumStr } from "../../common/types.js";
5
5
  import { Chain, VaultsApi } from "../../api/v2/index.js";
6
6
  /**
@@ -524,4 +524,17 @@ export declare class EVMVaultReader {
524
524
  * @returns Combined fee quote including native fee and expected amounts
525
525
  */
526
526
  getOFTFeeQuote(vaultId: string, sendParam: IOFTSendParam, payInLzToken?: boolean): Promise<IOFTFeeQuote>;
527
+ /**
528
+ * Quotes what a CCIP bridge send will cost.
529
+ *
530
+ * The counterpart to getOFTFeeQuote. CCIP charges one fee rather than
531
+ * LayerZero's native/LZ-token pair, and quotes no received amount: a
532
+ * burn-and-mint pool mints exactly what it burned, so the amount received is
533
+ * the amount sent.
534
+ *
535
+ * @param vaultId The vault (receipt token) address on the source chain
536
+ * @param sendParam Destination, receiver and amount
537
+ * @returns The fee and the token it is charged in
538
+ */
539
+ getCcipFeeQuote(vaultId: string, sendParam: ICcipSendParam): Promise<ICcipFeeQuote>;
527
540
  }
@@ -4,6 +4,8 @@ import EmberVaultABI from "../../abis/EmberVault.json" with { type: "json" };
4
4
  import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json" };
5
5
  import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
6
6
  import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
7
+ import CcipRouterABI from "../../abis/CcipRouter.json" with { type: "json" };
8
+ import { ZERO_ADDRESS, encodeCcipReceiver, encodeCcipExtraArgs } from "../utils/ccip.js";
7
9
  import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
8
10
  import EmberDepositParkingLotABI from "../../abis/EmberDepositParkingLot.json" with { type: "json" };
9
11
  import { Configuration, VaultsApi } from "../../api/v2/index.js";
@@ -736,4 +738,32 @@ export class EVMVaultReader {
736
738
  maxAmountLD: oftQuote.oftLimit.maxAmountLD
737
739
  };
738
740
  }
741
+ /**
742
+ * Quotes what a CCIP bridge send will cost.
743
+ *
744
+ * The counterpart to getOFTFeeQuote. CCIP charges one fee rather than
745
+ * LayerZero's native/LZ-token pair, and quotes no received amount: a
746
+ * burn-and-mint pool mints exactly what it burned, so the amount received is
747
+ * the amount sent.
748
+ *
749
+ * @param vaultId The vault (receipt token) address on the source chain
750
+ * @param sendParam Destination, receiver and amount
751
+ * @returns The fee and the token it is charged in
752
+ */
753
+ async getCcipFeeQuote(vaultId, sendParam) {
754
+ const pool = this.parser.getCcipTokenPoolByVaultAddress(vaultId);
755
+ if (!pool?.router) {
756
+ throw new Error(`CCIP token pool not found for vault: ${vaultId}`);
757
+ }
758
+ const feeToken = sendParam.feeToken ?? ZERO_ADDRESS;
759
+ const router = new Contract(pool.router, CcipRouterABI.abi, this.provider);
760
+ const fee = await router.getFee(sendParam.destinationChainSelector, {
761
+ receiver: encodeCcipReceiver(sendParam.receiver),
762
+ data: "0x",
763
+ tokenAmounts: [{ token: vaultId, amount: sendParam.amount }],
764
+ feeToken,
765
+ extraArgs: encodeCcipExtraArgs(sendParam.destinationGasLimit)
766
+ });
767
+ return { fee, feeToken };
768
+ }
739
769
  }
@@ -0,0 +1,23 @@
1
+ /** The native currency, as CCIP names it when no fee token is given. */
2
+ export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
3
+ /**
4
+ * Encodes a receiver for a CCIP message.
5
+ *
6
+ * CCIP carries the receiver as `bytes` rather than `address`, because the far
7
+ * end of a lane need not be an EVM chain. On an EVM destination that is the
8
+ * address left-padded to 32 bytes, which is why the same account looks
9
+ * different on the two sides of a transfer.
10
+ */
11
+ export declare const encodeCcipReceiver: (receiver: string) => string;
12
+ /**
13
+ * Encodes CCIP extraArgs.
14
+ *
15
+ * `allowOutOfOrderExecution` is true because a token transfer carries no
16
+ * message the destination has to apply in sequence; requiring ordering would
17
+ * make one stuck message block every later one on the lane.
18
+ *
19
+ * gasLimit is 0 by default: a plain token transfer runs no code on the
20
+ * destination beyond the pool's own mint, and paying for gas that is never used
21
+ * only raises the fee.
22
+ */
23
+ export declare const encodeCcipExtraArgs: (destinationGasLimit?: bigint) => string;
@@ -0,0 +1,32 @@
1
+ import { AbiCoder, getAddress, zeroPadValue } from "ethers";
2
+ /** The native currency, as CCIP names it when no fee token is given. */
3
+ export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
4
+ /**
5
+ * Tag for CCIP's EVMExtraArgsV2, the first four bytes of
6
+ * keccak256("CCIP EVMExtraArgsV2"). Verified against a deployed ramp.
7
+ */
8
+ const EVM_EXTRA_ARGS_V2_TAG = "0x181dcf10";
9
+ /**
10
+ * Encodes a receiver for a CCIP message.
11
+ *
12
+ * CCIP carries the receiver as `bytes` rather than `address`, because the far
13
+ * end of a lane need not be an EVM chain. On an EVM destination that is the
14
+ * address left-padded to 32 bytes, which is why the same account looks
15
+ * different on the two sides of a transfer.
16
+ */
17
+ export const encodeCcipReceiver = (receiver) => zeroPadValue(getAddress(receiver), 32);
18
+ /**
19
+ * Encodes CCIP extraArgs.
20
+ *
21
+ * `allowOutOfOrderExecution` is true because a token transfer carries no
22
+ * message the destination has to apply in sequence; requiring ordering would
23
+ * make one stuck message block every later one on the lane.
24
+ *
25
+ * gasLimit is 0 by default: a plain token transfer runs no code on the
26
+ * destination beyond the pool's own mint, and paying for gas that is never used
27
+ * only raises the fee.
28
+ */
29
+ export const encodeCcipExtraArgs = (destinationGasLimit = 0n) => {
30
+ const encoded = AbiCoder.defaultAbiCoder().encode(["uint256", "bool"], [destinationGasLimit, true]);
31
+ return EVM_EXTRA_ARGS_V2_TAG + encoded.slice(2);
32
+ };
@@ -1,4 +1,4 @@
1
- import { EvmOFTAdapter } from "../../api/v2/index.js";
1
+ import { EvmCcipLane, EvmCcipTokenPool, EvmOFTAdapter } from "../../api/v2/index.js";
2
2
  import { EvmProtocolInfo } from "../interfaces/index.js";
3
3
  export declare class EVMDeploymentParser {
4
4
  deployment: EvmProtocolInfo;
@@ -124,4 +124,49 @@ export declare class EVMDeploymentParser {
124
124
  * @param vaultAddress The vault address (receipt token address in EVM deployment data)
125
125
  */
126
126
  getOFTAdapterObjectByVaultAddress(vaultAddress: string): EvmOFTAdapter | undefined;
127
+ /**
128
+ * Finds the CCIP token pool entry for a given vault address.
129
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
130
+ */
131
+ getCcipTokenPoolByVaultAddress(vaultAddress: string): EvmCcipTokenPool | undefined;
132
+ /**
133
+ * Reports which bridge a vault uses, or undefined if it has none.
134
+ *
135
+ * A vault has exactly one active bridge, but different vaults use different
136
+ * ones, so call this before choosing between the LayerZero and CCIP send
137
+ * methods rather than assuming either.
138
+ *
139
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
140
+ */
141
+ getBridgeTransportByVaultAddress(vaultAddress: string): "LayerZero" | "CCIP" | undefined;
142
+ /**
143
+ * Lists the networks a vault can bridge to, whichever transport it uses.
144
+ *
145
+ * Returns an empty array for a vault with no bridge, so it is safe to render
146
+ * directly. Names are as the deployment records them, which is what
147
+ * bridgeSendTokenViaCcip takes as its destination.
148
+ *
149
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
150
+ */
151
+ getBridgeDestinationsByVaultAddress(vaultAddress: string): string[];
152
+ /**
153
+ * Finds the configured CCIP lane from a vault to a destination chain selector.
154
+ *
155
+ * A missing lane means the route is not configured and a send would revert.
156
+ *
157
+ * @param vaultAddress The vault address on the source chain
158
+ * @param remoteChainSelector The destination CCIP chain selector
159
+ */
160
+ getCcipLaneByVaultAndSelector(vaultAddress: string, remoteChainSelector: string): EvmCcipLane | undefined;
161
+ /**
162
+ * Finds the configured CCIP lane from a vault to a destination network.
163
+ *
164
+ * Lanes are keyed by the destination's CCIP chain selector, which nothing
165
+ * outside CCIP knows, so this looks the lane up by network name instead.
166
+ * A missing lane means the route is not configured — sending would revert.
167
+ *
168
+ * @param vaultAddress The vault address on the source chain
169
+ * @param destinationNetwork The destination network name, e.g. "atlantic"
170
+ */
171
+ getCcipLaneByVaultAndNetwork(vaultAddress: string, destinationNetwork: string): EvmCcipLane | undefined;
127
172
  }
@@ -206,4 +206,78 @@ export class EVMDeploymentParser {
206
206
  }
207
207
  return entry;
208
208
  }
209
+ /**
210
+ * Finds the CCIP token pool entry for a given vault address.
211
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
212
+ */
213
+ getCcipTokenPoolByVaultAddress(vaultAddress) {
214
+ return Object.values(this.deployment.contracts?.ccipTokenPools ?? {}).find(pool => pool.vaultAddress?.toLowerCase() === vaultAddress.toLowerCase());
215
+ }
216
+ /**
217
+ * Reports which bridge a vault uses, or undefined if it has none.
218
+ *
219
+ * A vault has exactly one active bridge, but different vaults use different
220
+ * ones, so call this before choosing between the LayerZero and CCIP send
221
+ * methods rather than assuming either.
222
+ *
223
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
224
+ */
225
+ getBridgeTransportByVaultAddress(vaultAddress) {
226
+ if (this.getCcipTokenPoolByVaultAddress(vaultAddress))
227
+ return "CCIP";
228
+ if (this.getOFTAdapterObjectByVaultAddress(vaultAddress))
229
+ return "LayerZero";
230
+ return undefined;
231
+ }
232
+ /**
233
+ * Lists the networks a vault can bridge to, whichever transport it uses.
234
+ *
235
+ * Returns an empty array for a vault with no bridge, so it is safe to render
236
+ * directly. Names are as the deployment records them, which is what
237
+ * bridgeSendTokenViaCcip takes as its destination.
238
+ *
239
+ * @param vaultAddress The vault address (receipt token address in EVM deployment data)
240
+ */
241
+ getBridgeDestinationsByVaultAddress(vaultAddress) {
242
+ // Both transports record the far end the same way, under remoteNetwork,
243
+ // but one keys its map by CCIP chain selector and the other by LayerZero
244
+ // endpoint id — neither of which a caller has any way to resolve. Reading
245
+ // the values rather than the keys is what keeps the two symmetric.
246
+ const pool = this.getCcipTokenPoolByVaultAddress(vaultAddress);
247
+ const adapter = this.getOFTAdapterObjectByVaultAddress(vaultAddress);
248
+ const networks = [
249
+ ...Object.values(pool?.lanes ?? {}),
250
+ ...Object.values(adapter?.peers ?? {})
251
+ ]
252
+ .map(entry => entry.remoteNetwork)
253
+ .filter((network) => !!network);
254
+ return [...new Set(networks)];
255
+ }
256
+ /**
257
+ * Finds the configured CCIP lane from a vault to a destination chain selector.
258
+ *
259
+ * A missing lane means the route is not configured and a send would revert.
260
+ *
261
+ * @param vaultAddress The vault address on the source chain
262
+ * @param remoteChainSelector The destination CCIP chain selector
263
+ */
264
+ getCcipLaneByVaultAndSelector(vaultAddress, remoteChainSelector) {
265
+ // Lanes are keyed by selector, so this is a direct hit rather than the
266
+ // scan the by-network lookup has to do.
267
+ return this.getCcipTokenPoolByVaultAddress(vaultAddress)?.lanes?.[remoteChainSelector];
268
+ }
269
+ /**
270
+ * Finds the configured CCIP lane from a vault to a destination network.
271
+ *
272
+ * Lanes are keyed by the destination's CCIP chain selector, which nothing
273
+ * outside CCIP knows, so this looks the lane up by network name instead.
274
+ * A missing lane means the route is not configured — sending would revert.
275
+ *
276
+ * @param vaultAddress The vault address on the source chain
277
+ * @param destinationNetwork The destination network name, e.g. "atlantic"
278
+ */
279
+ getCcipLaneByVaultAndNetwork(vaultAddress, destinationNetwork) {
280
+ const pool = this.getCcipTokenPoolByVaultAddress(vaultAddress);
281
+ return Object.values(pool?.lanes ?? {}).find(lane => lane.remoteNetwork?.toLowerCase() === destinationNetwork.toLowerCase());
282
+ }
209
283
  }
@@ -1,2 +1,3 @@
1
1
  export * from "./deployment-parser.js";
2
2
  export * from "./permit-utils.js";
3
+ export * from "./ccip.js";
@@ -1,2 +1,3 @@
1
1
  export * from "./deployment-parser.js";
2
2
  export * from "./permit-utils.js";
3
+ export * from "./ccip.js";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@ember-finance/sdk",
3
3
  "description": "Ember Protocol SDK",
4
- "version": "2.22.0",
4
+ "version": "2.23.0",
5
5
  "type": "module",
6
6
  "module": "./dist/index.js",
7
7
  "main": "./dist/index.js",