v1.4.x

Major Features

• Support for credit cards as an origin network (onramping)- off ramping to come in a future release

• Increased security by signing a message containing the transaction details

• More accurate fee estimation. This endpont also returns the amounts used for the allowance and submtting the transaction.

🚨 Breaking Changes

UPGRADING TO v1.4.x IS REQUIRED FOR ALL KIMA SDK USERS. These new features introduce breaking changes to how Kima tranasctions are submitted and processed. Once these features are live on mainnet, transactions sent using an older version of the SDK will be rejected by the chain.

These features will be rolled out first to testnet so developers have a period of time to migrate their apps ahead of the mainnet release.

• The Kima fee estimation endpoint must be used to calculate the gas and service fees. It returns a feeId which must be passed to the /submit endpoint in the backend.

• The user must sign a message containing the transaction details and include the signature in the /submit request.

• Credit card transactions cannot be processed using only the backend

  • The frontend kima-transaction-widget is required as it must handle KYC and interactions with 3rd party widgets.

• The widget props excludedSourceNetworks and excludedTargetNetworks have been removed

  • This is now done on the backend using the KIMA_CHAIN_FILTER environment variable

Widget

While we're in the testnet only period, install the RC version of the React Component. After mainnet launch, the final version will be published to NPM.

npm install @kimafinance/kima-transaction-widget@1.4.0-rc.2

There are no new ENV variables or Widget props.

Backend

Navigate to the kima-transaction-backend repo. For the testnet only version change to the dev-v1.4 branch and and pull the latest version. After mainnet launch, the final version will be merged to main.

git fetch
git checkout dev-v1.4
git pull

ENV Variables

There are some new ENV vars and existing ones which have changed. See the .env.example file.

New ENV vars:

• PAYMENT_PARTNER_ID: required for credit card transactions

  • Mainnet: Kima

  • Sardis Testnet: KimaTest

Changed:

• KIMA_BACKEND_FEE_URL

  • Mainnet: TBD

  • Sardis Testnet: https://fcs.sardis.kima.network

Disabling Credit Cards

If your app should not support credit cards, the "Credit Card" network can be filtered out using an ENV variable in the Kima Transaction Backend > Chain Filtering.