✈️SDK Migration (5.x → 7.x)

Version 7.x expands address support beyond EVM to include Solana addresses, XRPL addresses, and email identifiers. Several function names and parameters have been updated to reflect these multi-network capabilities.

Summary of changes

What changed	v5.x	v7.x
Identify user	sendConnectWallet	identifyUser
Affiliate code params	address + signature	userIdentifier + identifierType + signature
Identify user params	address + signature	identifier + identifierType + signature
Get referrer	getUserAffiliates (per-conversion)	getUserReferrer (per-project)

1. sendConnectWallet → identifyUser

v5.x

import { Fuul } from '@fuul/sdk';

await Fuul.sendConnectWallet({
  address: '0x1234...',
  signature: '0x5678...',
  message: 'Accept affiliate on 18-Aug 2023 00:00:00',
});

v7.x

import { Fuul } from '@fuul/sdk';

await Fuul.identifyUser({
  identifier: '0x1234...',
  identifierType: 'evm_address', // evm_address | solana_address | xrpl_address
  signature: '0x5678...',
  signaturePublicKey: '0x1234...', // Only for XRPL signatures
  message: 'Accept affiliate on 18-Aug 2023 00:00:00',
});

For more information, see Tracking Referrals.

2. Affiliate code parameters

v5.x

import { Fuul } from '@fuul/sdk';

await Fuul.createAffiliateCode({
  address: '0x1234...',
  code: 'my-affiliate-code',
  signature: '0x5678...',
});

await Fuul.updateAffiliateCode({
  address: '0x1234...',
  code: 'my-new-code',
  signature: '0x5678...',
});

v7.x

import { Fuul } from '@fuul/sdk';

await Fuul.createAffiliateCode({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address', // evm_address | solana_address | xrpl_address
  signature: '0x5678...',
  signaturePublicKey: '0x1234...', // Only for XRPL signatures
  code: 'my-affiliate-code',
});

await Fuul.updateAffiliateCode({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address',
  signature: '0x5678...',
  signaturePublicKey: '0x1234...',
  code: 'my-new-code',
});

For more information, see Affiliate Links & Codes.

3. Getting the user referrer

getUserAffiliates has been replaced by getUserReferrer.

	v5.x (getUserAffiliates)	v7.x (getUserReferrer)
Returns	Array of conversions, each with its referrer	A single referrer
Attribution level	Per conversion	Per project

Attribution is now defined at the project level instead of per conversion, so getUserReferrer returns a single referrer for the user rather than one per conversion.