LogoLogo
LogoLogo
  • FORMLESS NETWORK
    • Overview
  • SHARE
    • SHARE SDK
      • Authentication
      • Payouts
      • Smart Contracts
      • Prepaying for API Credits
    • SHARE App
      • Smart Contract Creation
        • Sell a Beat
        • Sell a Song
        • Sell a Video
        • Sell an Album
        • Sell a Collection with Community Splits
        • Create a Community Splits Contract
      • Frequently Asked Questions
    • SHARE Protocol
  • TUTORIALS
    • Cashing Out to Your Bank
    • Collections Revenue Flow
    • For Symphonic Customers
      • Get Your Streaming Money Paid Out Same Day
      • Share Streaming Money with Fans
      • Add SHARE Protocol as a Payee
      • Assign Royalty Splits to SHARE Protocol
      • Connect Track Earnings to a Smart Contract using a Form
      • Connect Track Earnings to a Smart Contract using SHARE SDK
      • Receiving Realtime Royalty Payouts
    • For Distribution Businesses
      • Getting Started
      • SHARE Enterprise Dashboard
        • Your Custom Branded Portal
        • Logging in and Adding Authorized Users
        • Viewing Your Revenue Analytics and Balance
        • Viewing Customers
        • How Revenue Splits Work on D2C Sales
      • SHARE API and SDK Access
        • Shared Ownership and Large-Scale Fractionalized Payouts
        • Connect DSP Earnings to SHARE with No-Code
        • How Your Customers Can Create Splits Contracts
        • Create a Community Splits Contract using SHARE UI
        • Execute a Programmatic Payment
        • How to Verify FORMLESS Account IDs
        • Add SHARE Protocol Split Contract as a Payee
Powered by GitBook
On this page
  1. TUTORIALS
  2. For Symphonic Customers

Connect Track Earnings to a Smart Contract using SHARE SDK

This guide gives step by step instructions for creating a smart contract and connecting it to a track distributed by Symphonic.

PreviousConnect Track Earnings to a Smart Contract using a FormNextReceiving Realtime Royalty Payouts

Last updated 4 months ago

This feature is currently in pilot stage and is available to select Symphonic customers only. If you're interested in working with us, please email info@formless.xyz.

  1. First, please ensure you've followed these prerequisite steps:

    1. Signed up for a which includes API access.

    2. in Symphonic.

    3. for your track.

    4. After assigning royalty splits to SHARE, you will need to wait until our system synchronizes tracks from Symphonic, which happens weekly on Fridays. You can proceed with this guide in the interim, but be advised that smart contracts will not receive revenue until tracks are synchronized. If you need to fast track synchronization, please send an email to developers@formless.xyz and we'll do our best to accommodate.

  2. Navigate to Symphonic -> Split Share -> Tracks.

  3. Copy the ISRC and UPC codes for your track. For example ISRC GBRKQ2173603 and UPC 193872934235in the image below.

curl -L -X POST 'https://share-ddn.formless.xyz/v1' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <API_KEY>' \
-d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "contracts_create",
    "params": {
        "type": "digital_property_with_revenue_share",
        "network": "polygon",
        "title": "CELEBRITY / BLACK TUXES",
        "description": "80/20 split from Spotify and Apple Music.",
        "creator_name": "Brandon Tory",
        "revenue_source": {
            "distributor": "symphonic",
            "product": {
                "isrc": "GBRKQ2173603",
                "upc": "193872934235"
            }
        },
        "revenue_share": {
            "recipients": {
                "alice@formless.xyz" : 40,
                "bob@formless.xyz" : 40
            },
            "community_allocation_percent": 20,
            "community_split_count": 20,
            "distribution_unit": {
                "value": 0.05,
                "currency": "USD"
            }
        }
    }
}'
  1. (Optional) If you're sharing revenue with fans, invite people to join in the revenue sharing experience by copying the join_splits_url . If you're not sharing revenue with fans, you can skip this step.

{

  "jsonrpc": "2.0",
  "id": "2",
  "result": {
    "status": "success",
    "code": 200,
    "network_id": 10,
    "blockchain_name": "optimism",
    "revenue_share_smart_contract_address": "0x12ccE423000299FDd6681b081125E620F4eb6890",
    "digital_property_contract_address": "0x48209bb921259Fb4F3740414Ecc0A0013922a45c",
    "digital_property_contract_id": "8bfd3d5f-4d12-41f8-b8c4-ab81aa978456",
    "join_splits_url": "https://share.formless.xyz/splits/polygon/0x48209bb921259Fb4F3740414Ecc0A0013922a45c"
  }
}
  1. (Optional) You can also customize your link by adding the Spotify and Apple Music links to the metadata. This is completely optional and has no impact on the royalty revenue flow.

curl -L -X POST 'https://share-ddn.formless.xyz/v1' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <API_KEY>' \
-d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "contracts_metadata_write",
    "params": {
        "contract_id": "8bfd3d5f-4d12-41f8-b8c4-ab81aa978456",
        "metadata": {
            "preview": {
                "linked_metadata": [
                    {
                        "visible": true,
                        "name": "SPOTIFY",
                        "uri": "https://open.spotify.com/track/3r8hQGdAEuZZRDMRzvivib?si=a9c65070c25744d6"
                    },
                    {
                        "visible": true,
                        "name": "APPLE MUSIC",
                        "uri": "https://music.apple.com/us/album/celebrity-black-tuxes-feat-bankxy-izz508/1582053240?i=1582053245"
                    }
                ]
            }
        }
    }
}'

Important Points

Your fans and collaborators do not need to know anything about cryptocurrency to get their splits. It is all done through email and is as simple as pressing the JOIN button on the link.

Your fans and collaborators do not need to know anything about cryptocurrency to cash out their earnings.

Tracks with large amounts of splits result in small micropayments being paid out to split owners over time instead of all at once. This means that over the lifetime of the track, all split owners will be paid out equally, although on a given day some may earn more than others. This design overcomes the challenge of paying out small amounts of money to lots of people at once without incurring prohibitive fees.

Create a digital property with revenue sharing smart contract using . Earnings from DSPs will be connected to the smart contract using the revenue_source field which includes the distributor, ISRC and UPC codes.

In the command above we've already added collaborators to the splits, and . They'll each receive 40% of earnings, and if they don't already have one, a FORMLESS account and digital wallet will be created for them. Collaborators will receive an email like this when added to the splits:

Once your join splits link is created you can sharing it in engaging ways on social media. For example, by telling your followers that the first 100 people to reshare a post get splits on the song. This is completely up to you, and you can read our case studies on how others have succeeded.

Done! Next, learn more about and .

SHARE SDK
alice@formless.xyz
bob@formless.xyz
here
Receiving Realtime Royalty Payouts
Cashing Out to Your Bank
Add SHARE Protocol as a Payee
Assign Royalty Splits to SHARE Protocol
Symphonic -> SplitShare -> Tracks. Note that the track already has splits assigned to SHARE PROTOCOL, as a result of the "Assign Royalty Splits to SHARE" step above.
You'll receive a confirmation email upon completion.
Your smart contract is available for view using this join splits link.
Business & Developer Account