Liquid Splits

Liquid Splits

Begin by importing LiquidSplitClient into your app. If you are using the SplitsClient, you can access the liquid split client as well.

import { LiquidSplitClient } from '@0xsplits/splits-sdk'
 
const liquidSplitClient = new LiquidSplitClient({
  chainId,
  publicClient, // viem public client (optional, required if using any of the contract functions)
  walletClient, // viem wallet client (optional, required if using any contract write functions. must have an account already attached)
  includeEnsNames, // boolean, defaults to false. If true, will return ens names for any liquid split holder (only for mainnet)
  // If you want to return ens names on chains other than mainnet, you can pass in a mainnet public client
  // here. Be aware though that the ens name may not necessarily resolve to the proper address on the
  // other chain for non EOAs (e.g. Gnosis Safe's)
  ensPublicClient, // viem public client (optional)
})

OR

import { SplitsClient } from '@0xsplits/splits-sdk'
 
const splitsClient = new SplitsClient({
  chainId,
  publicClient,
  walletClient,
  includeEnsNames,
  ensPublicClient,
})
 
const liquidSplitClient = splitsClient.liquidSplits

Now you're ready to use any of the functions. All Arguments and Responses for these functions are objects. This will make it easier for us to release updates to the SDK without breaking existing implementations.

The SDK comprises 3 different types of functions: Subgraph Reads, Liquid Split Writes, and Liquid Split Reads.

Subgraph Reads

These functions make it easier to query the subgraph.

getLiquidSplitMetadata

Returns all metadata for a given liquidSplitAddress.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
}
 
const response = await liquidSplitClient.getLiquidSplitMetadata(args)

Arguments

{
  liquidSplitAddress: string
}

Response

{
  type: 'LiquidSplit'
  address: string
  distributorFeePercent: number
  payoutSplitAddress: string
  isFactoryGenerated: boolean
  holders: {
    percentAllocation: number
    recipient: {
      address: string
      ensName?: string
    }
  }[]
}

Liquid Split Writes

These functions make it easier to call Liquid Split functions.

createLiquidSplit

Creates a new Liquid Split contract.

Usage

const args = {
  holders: [
    {
      address: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f";
      percentAllocation: 50.0
    },
    {
      address: "0xc3313847E2c4A506893999f9d53d07cDa961a675";
      percentAllocation: 50.0
    }
  ]
  distributorFeePercent: 1.0000
  owner: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f",
}
 
const response = await liquidSplitClient.createLiquidSplit(args)

Arguments

{
  holders: {
    address: string;
    percentAllocation: number # >0 and <100 and up to 1 decimal
  }[]
  distributorFeePercent: number # <10 and up to 4 decimals
  owner?: string # defaults to signer
}

Response

{
  liquidSplitAddress: string
  event: Log # CreateLS1155Clone emitted on LiquidSplitFactory
}

distributeToken

Distributes the current token balance for the given liquid split to the current NFT holders

Usage

const args = {
  liquidSplitAddress: "0xb5Ce41320F3d486671918733BB3226E3981Db62b"
  token: "0x64d91f12ece7362f91a6f8e7940cd55f05060b92"
  distributorAddress: "0x2fa128274cfcf47afd4dc03cd3f2a59af09b6a72"
}
 
const response = await liquidSplitClient.distributeToken(args)

Arguments

{
  liquidSplitAddress: string
  token: string
  distributorAddress?: string # defaults to signer
}

Response

{
  event: Log # DistributeETH or DistributeERC20 emitted on the Liquid Split contract
}

transferOwnership

Transfer ownership of the given liquid split to the newOwner. Only callable by the owner of the liquid split contract.

Usage

const args = {
  liquidSplitAddress: "0xb5Ce41320F3d486671918733BB3226E3981Db62b"
  newOwner: "0x2fa128274cfcf47afd4dc03cd3f2a59af09b6a72",
}
 
const response = await liquidSplitClient.transferOwnership(args)

Arguments

{
  liquidSplitAddress: string
  newOwner: string
}

Response

{
  event: Log # OwnershipTransferred emitted on the Liquid Split contract
}

Gas Estimation

The client has a gas estimation feature that can be used with any of the above write functions. Just call the function off of the estimateGas property. Estimating the gas for the create liquid split function would look like:

const args = {
  holders: [
    {
      address: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f";
      percentAllocation: 50.0
    },
    {
      address: "0xc3313847E2c4A506893999f9d53d07cDa961a675";
      percentAllocation: 50.0
    }
  ]
  distributorFeePercent: 1.0000
  owner: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f",
}
 
const gasEstimate = await liquidSplitClient.estimateGas.createLiquidSplit(args)

CallData

The client has a call data feature that can be used with any of the above write functions. Just call the function off of the callData property. Generating call data for the create liquid split function would look like:

const args = {
  holders: [
    {
      address: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f";
      percentAllocation: 50.0
    },
    {
      address: "0xc3313847E2c4A506893999f9d53d07cDa961a675";
      percentAllocation: 50.0
    }
  ]
  distributorFeePercent: 1.0000
  owner: "0x442C01498ED8205bFD9aaB6B8cc5C810Ed070C8f",
}
 
const callData = await liquidSplitClient.callData.createLiquidSplit(args)

Liquid Split Reads

These functions make it easier to query the Liquid Split contracts.

getDistributorFee

Returns the distributor fee of a given liquidSplitAddress.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
}
 
const response = await liquidSplitClient.getDistributorFee(args)

Arguments

{
  liquidSplitAddress: string
}

Response

{
  distributorFee: number
}

getPayoutSplit

Returns the payout split of a given liquidSplitAddress.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
}
 
const response = await liquidSplitClient.getPayoutSplit(args)

Arguments

{
  liquidSplitAddress: string
}

Response

{
  payoutSplitId: string
}

getOwner

Returns the owner of a given liquidSplitAddress.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
}
 
const response = await liquidSplitClient.getOwner(args)

Arguments

{
  liquidSplitAddress: string
}

Response

{
  owner: string
}

getUri

Returns the uri of a given liquidSplitAddress.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
}
 
const response = await liquidSplitClient.getUri(args)

Arguments

{
  liquidSplitAddress: string
}

Response

{
  uri: string
}

getScaledPercentBalanceOf

Returns the current percent ownership of a given liquidSplitAddress for an address.

Usage

const args = {
  liquidSplitAddress: '0xb5Ce41320F3d486671918733BB3226E3981Db62b',
  address: '0x2fa128274cfcf47afd4dc03cd3f2a59af09b6a72',
}
 
const response = await liquidSplitClient.getScaledPercentBalanceOf(args)

Arguments

{
  liquidSplitAddress: string
  address: string
}

Response

{
  scaledPercentBalance: number
}