[](https://travis-ci.org/Chung Tran/FeeRelayerSwift)
To run the example project, clone the repo, and run pod install from the Example directory first.
FeeRelayerSwift is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'FeeRelayerSwift', :git => 'https://github.com/p2p-org/FeeRelayerSwift.git'import SolanaSwift
// Get token to pay fees (choose by user)
let payingFeeToken = FeeRelayerSwift.TokenAccount(address: <#PublicKey#>, mint: <#PublicKey#>)
// Example: SolanaAccountStorage
class AccountStorage: SolanaAccountStorage {
...
}
// Initialize services
let accountStorage = AccountStorage()
let solanaAPIClient = JSONRPCAPIClient(endpoint: <#APIEndPoint#>)
let blockchainClient = BlockchainClient(apiClient: solanaAPIClient)
let feeRelayerAPIClient = FeeRelayerSwift.APIClient(baseUrlString: <#String#>, version: 1)
let contextManager = FeeRelayerContextManagerImpl(
accountStorage: accountStorage,
solanaAPIClient: solanaAPIClient,
feeRelayerAPIClient: feeRelayerAPIClient
)
let orcaSwap = OrcaSwap(
apiClient: OrcaSwapSwift.APIClient(
configsProvider: OrcaSwapSwift.NetworkConfigsProvider(
network: "mainnet-beta"
)
),
solanaClient: solanaAPIClient,
blockchainClient: blockchainClient,
accountStorage: accountStorage
)
let feeRelayer = FeeRelayerService(
orcaSwap: orcaSwap,
accountStorage: accountStorage,
solanaApiClient: solanaAPIClient,
feeCalculator: DefaultFreeRelayerCalculator(),
feeRelayerAPIClient: feeRelayerAPIClient,
deviceType: .iOS,
buildNumber: <#String#>
)
// Load and update services
let _ = try await (
orcaSwap.load(),
contextManager.update()
)
let context = try await contextManager.getCurrentContext()
// Calculate the expected transaction fee
let expectedTransactionFee = context.lamportsPerSignature * <#Int#> // 1 for the owner, 1 for company's FeePayer (if required) and additional signature if required
// when free transaction is not available and user is paying with sol, let him do this the normal way (don't use fee relayer)
let userIsPayingWithNativeSOL = payingTokenMint == PublicKey.wrappedSOLMint.base58EncodedString
let freeTransactionIsNotAvailable = context.usageStatus.isFreeTransactionFeeAvailable(transactionFee: expectedFee.transaction) == false
let ignoreFeeRelayer = userIsPayingWithNativeSOL && freeTransactionIsNotAvailable
// Define fee payer and weather FeeRelayer needed or not
let useFeeRelayer = !ignoreFeePayer
let feePayer = useFeeRelayer ? contextManager: nil // feePayer == nil mean the owner has to pay the fee
// Prepare transaction
// Ex1: Sending native SOL
var preparedTransaction = blockchainClient.prepareSendingNativeSOL(from: accountStorage.account, to: receiver, amount: <#Lamports#>, feePayer: feePayer)
// Get recent blockhash
preparedTransaction.transaction.recentBlockhash = try await solanaAPIClient.getRecentBlockhash(commitment: nil)
// Relay transaction if needed
if useFeeRelayer {
return try await feeRelayer.topUpAndRelayTransaction(
context,
preparedTransaction,
fee: payingFeeToken,
config: .init(
operationType: .transfer,
currency: <#String#>
) // for analytics purpose only
)
} else {
return try await blockchainClient.sendTransaction(preparedTransaction: preparedTransaction)
}To run relay tests, create a valid file with name relay-tests.json inside Tests/Resources, contains following content (without comments):
{
"baseUrlString": <String>, // FeeRelayer's server url
"topUp": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payingTokenAddress": "mCZrAFuPfBDPUW45n5BSkasRLpPZpmqpY7vs3XSYE7x",
"amount": 10000
},
"solToSPL": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"fromMint": "So11111111111111111111111111111111111111112",
"toMint": "2Kc38rfQ49DFaKHQaWbijkE7fcymUMLY5guUiUsDmFfn",
"sourceAddress": <String>,
"destinationAddress": <String>,
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payingTokenAddress": <String>,
"inputAmount": 100000,
"slippage": 0.2,
"comment": "Swap 0.0001 SOL to KURO paid with USDC"
},
"splToSOL": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"fromMint": <String>,
"toMint": "So11111111111111111111111111111111111111112",
"sourceAddress": <String>,
"destinationAddress": <String>,
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"payingTokenAddress": <String>,
"inputAmount": 10000000,
"slippage": 0.2,
"comment": "Swap 10 KURO to SOL paid with USDC"
},
"splToCreatedSpl": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"fromMint": <String>, // Mint of token that you want to swap from
"toMint": <String>, // Mint of token that you want to swap to
"sourceAddress": <String>, // Source token address
"destinationAddress": <String?>, // Destination token address
"payingTokenMint": <String>, // Mint of token that you want to use to pay fee
"payingTokenAddress": <String>, // Address of token that have enough balance to cover fee
"inputAmount": 1000000, // Input amount in lamports
"slippage": 0.05
},
"splToNonCreatedSpl": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"fromMint": <String>, // Mint of token that you want to swap from
"toMint": <String>, // Mint of token that you want to swap to
"sourceAddress": <String>, // Source token address
"destinationAddress": null, // Destination token address
"payingTokenMint": <String>, // Mint of token that you want to use to pay fee
"payingTokenAddress": <String>, // Address of token that have enough balance to cover fee
"inputAmount": 1000000, // Input amount in lamports
"slippage": 0.05
},
"usdtTransfer": { // relay_transfer_spl_token
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"sourceTokenAddress": "mCZrAFuPfBDPUW45n5BSkasRLpPZpmqpY7vs3XSYE7x",
"destinationAddress": "9BDAsqBpawnEmaJnMJo8NPqyL8HrT6AdujnuFsy4m8sj",
"inputAmount": 100,
"payingTokenAddress": "mCZrAFuPfBDPUW45n5BSkasRLpPZpmqpY7vs3XSYE7x",
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
"usdtBackTransfer": { // relay_transfer_spl_token
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"sourceTokenAddress": "9BDAsqBpawnEmaJnMJo8NPqyL8HrT6AdujnuFsy4m8sj",
"destinationAddress": "mCZrAFuPfBDPUW45n5BSkasRLpPZpmqpY7vs3XSYE7x",
"inputAmount": 100,
"payingTokenAddress": "9BDAsqBpawnEmaJnMJo8NPqyL8HrT6AdujnuFsy4m8sj",
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
"usdtTransferToNonCreatedToken": {
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"sourceTokenAddress": "9BDAsqBpawnEmaJnMJo8NPqyL8HrT6AdujnuFsy4m8sj",
"destinationAddress": "7hTyqUwMQF24B63M4vRzjYGsJ5VBiL7WiSZJ29LQQwE8",
"inputAmount": 100,
"expectedFee": 10000,
"payingTokenAddress": "9BDAsqBpawnEmaJnMJo8NPqyL8HrT6AdujnuFsy4m8sj",
"payingTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
"relaySendNativeSOL": { // relay_transaction
"endpoint": <String>, // Solana api endpoint
"endpointAdditionalQuery": <String?>,
"seedPhrase": <String>, // Solana account seed phrase
"destinationAddress": <String?>, // Destination token address
"inputAmount": 1000000, // Input amount in lamports
"payingTokenMint": <String>, // Mint of token that you want to use to pay fee
"payingTokenAddress": <String>, // Address of token that have enough balance to cover fee
}
}Chung Tran, [email protected]
FeeRelayerSwift is available under the MIT license. See the LICENSE file for more info.