Royalty allows you to manage royalty payments and claims within Story.
Method |
---|
pay_royalty_on_behalf |
receiver_ip_id
: The ipId that receives the royalties.payer_ip_id
: The ID of the IP asset that pays the royalties.token
: The token to use to pay the royalties.amount
: The amount to pay.tx_options
: [Optional] The transaction options dictionary.Method |
---|
claimable_revenue |
royalty_vault_ip_id
: The id of the royalty vault.claimer
: The address of the royalty token holder.token
: The revenue token to claim.Method |
---|
claim_all_revenue |
ancestor_ip_id
: The address of the ancestor IP from which the revenue is being claimed.claimer
: The address of the claimer of the currency (revenue) tokens. This is normally the ipId of the ancestor IP if the IP has all royalty tokens. Otherwise, this would be the address that is holding the ancestor IP royalty tokens.child_ip_ids
: The addresses of the child IPs from which royalties are derived.royalty_policies
: The addresses of the royalty policies, where royalty_policies[i] governs the royalty flow for child_ip_ids[i].currency_tokens
: The addresses of the currency tokens in which royalties will be claimed.claim_options
: [Optional]
claim_options['auto_transfer_all_claimed_tokens_from_ip']
: [Optional] When enabled, all claimed tokens on the claimer are transferred to the wallet address if the wallet owns the IP. If the wallet is the claimer or if the claimer is not an IP owned by the wallet, then the tokens will not be transferred. Set to False to disable auto transferring claimed tokens from the claimer. Default: Trueip_id
.
Method |
---|
get_royalty_vault_address |
ip_id
: the ipId
associated with the royalty vault.Method |
---|
transfer_to_vault |
ip_id
: The ID of the IP asset that pays the royalties.ancestor_ip_id
: The ID of the ancestor IP asset.token
: The token address to transfer.royalty_policy
: [Optional] The royalty policy to use (“LAP” or “LRP”). Default: “LAP”tx_options
: [Optional] The transaction options dictionary.