> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/developer-guide/migrating-from-5.x-to-7.x-version.md).

# 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**

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

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

**v7.x**

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

await Fuul.identifyUser({
  identifier: '0x1234...',
  identifierType: 'evm_address', // evm_address | solana_address | xrpl_address | sui_address | stellar_address | email
  signature: '0x5678...',
  message: 'Accept affiliate on 18-Aug 2023 00:00:00',
});
```

For more information, see [Tracking Referrals](/developer-guide/tracking-referrals-in-your-app.md).

## 2. Affiliate code parameters

**v5.x**

```typescript
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**

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

await Fuul.createAffiliateCode({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address', // evm_address | solana_address | xrpl_address | sui_address | stellar_address | email
  signature: '0x5678...',
  code: 'my-affiliate-code',
});

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

For more information, see [Affiliate Links & Codes](/developer-guide/creating-affiliate-links-or-codes.md).

## 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.