Intersect WebsiteBecome a member

Requirements

Project Scope - Technical Requirements

Each grantee will implement CIP-149 | Optional DRep Compensation functionality tailored to their platform:

a) Wallets

b) Governance Tools

c) SDKs/Libraries

Due to variance within SDK/Library design and functionality, there is flexibility with proposed implementations, suggested functions:

  • Add functions for creating CIP-149 DRep delegation transactions.

    • The motivation for this is to governance tool makers a straight forward way to build DRep delegation transactions, containing CIP-149 compliant metadata.

    • i.e. As a part of transaction building, give users methods to add CIP149 compliant metadata transaction.addCIP149Delegation(stakeAddr, dRepID, donationBasisPoints)

    // Eample of what interfaces and functions could look like
// SDKs and libraries are free to interpret and implement as suits their implementation

// values based on (preview): 8c86970a2431a9f43a0363b116b4c60471a29cc35d253c0ed8c18c1dff3dcf10

const stakeAddr = "stake1u8sa8kegf22wcjqqlc0230rtlemck5lhqycd3u8lattqh2cdjuzs4"
const dRepID = "drep1yfhx2j5j7q989gfvj6cg04htakpqn32a3yuhtytjxt9m80qt5ekm3"
const donationBasisPoints = 150 // 15% donation

/** 
* Where transaction is an existing object from library (something else can be used)
* addCIP149Metadata adds a VoteDelegation certificate and CIP149 compliant metadata
*/
transaction.addCIP149Delegation(stakeAddr, dRepID, donationBasisPoints)

console.log(transaction.toJson())
/**
...
"certs":[
    0:{
      "VoteDelegation":{
        "stake_credential":{
          "Key":"e1d3db284a94ec4800fe1ea8bc6bfe778b53f70130d8f0ffea…"
        }
        "drep":{
          "KeyHash":"6e654a92f00a72a12c96b087d6ebed8209c55d893975917232…"
        }
      }
    }
  ]
...
"auxiliary_data":{
  "metadata":{ 
    "3692": {
      donationBasisPoints: 150
    }
  }
}
...
*/

  • Add functions for indexing CIP-149 delegation transactions.

    • The motivation for this is to wallets and governance tool makers an example implementation of how to index chain to find a given stake credential's CIP-149 delegations.

    • i.e. When a wallet is building a staking reward withdrawal transaction getLastestCIP149Delegation()

    // Example of what interfaces and functions could look like
// SDKs and libraries are free to interpret and implement as suits their implementation

interface CIP149Delegation {
  txId: string;
  drepId: string;
  drepPaymentAddr: string;
  basisPoints: number;
}

/**
 * NoCIP149Delegation: The stakeKey has not delegated to a DRep using CIP149 correctly
 * NoDRepPaymentAddr: The DRep has not included payment address in their metadata
 */
interface CIP149DelegationError {
  type: "NoCIP149Delegation" | "NoDRepPaymentAddr" ; // some more error cases
  message: string;
}

/**
 * getLastestCIP149Delegation triggers a chain query (using a given provider)
 * to find the most recent valid CIP149 delegation.
 * Indexing will invovle indexing the stakeKey's most recent vote delegation transacion
 * its transaction metadata and the DRep's latest metadata (to find DRep's payment address)
 */
const cip149Delegation: CIP149Delegation | CIP149DelegationError = getLastestCIP149Delegation("stake1u8sa8kegf22wcjqqlc0230rtlemck5lhqycd3u8lattqh2cdjuzs4")

const rewardsAvaliable = 100 // 100 ada avaliable in rewards account

/**
 * Where withdrawalTransaction is an existing object from library (something else can be used)
 * The wallet can then use this information, to build the withdrawal transaction
 * using drepPaymentAddr and basisPoints to donate to the DRep
 */
withdarawalTransaction.addRewardsWithdrawal(rewardsAvaliable)
withdrawalTransaction.addOutput(cip149Delegation.drepPaymentAddr, (rewardsAvaliable/100 * cip149Delegation.basisPoints/10))

Example Transactions

Staking Address: stake_test1ursa8kegf22wcjqqlc0230rtlemck5lhqycd3u8lattqh2c2ckq5g DRep ID: drep1yfhx2j5j7q989gfvj6cg04htakpqn32a3yuhtytjxt9m80qt5ekm3 DRep's most recent registration/update transaction: 337a2dc8ef4f2e139fae3c1f8a5eb25d7441d29db653417d6fe5883ea3e49227 DRep's most recent metadata: https://ipfs.io/ipfs/bafkreiaebdt43kqssaajkcpbg7wab5vq4g6e5kzwf4pals74lqk744wjrq DRep's payment address (from metadata): addr_test1vp8vlxck6kvndekp0fudqvlhc0lj5jvuk4a57ma7sqh0ucsmny9t3

CIP-149 DRep Delegation

Transaction: 8c86970a2431a9f43a0363b116b4c60471a29cc35d253c0ed8c18c1dff3dcf10

This transaction contains, both a Vote Delegation certificate and CIP-149 transaction metadata.

  • Vote Delegation certificate: This delegates the voting rights of stake_test1ursa...kq5g to drep1yfh...ekm3.

  • CIP-149 Metadata: using the 3692 metadatum label the transaction metadata specifies donationBasisPoints: 150 which is a donation of 15%.

CIP-149 Staking Rewards withdrawal

Transaction: 38641cd70b0ab300e4fb850e7a0c747bac54d894bdc9deb07e934c0c0e4c6223

This transaction contains, a staking rewards withdrawal (of 700,000 ada) and two outputs, one to stake_test1ursa...kq5g's chosen DRep (drep1yfh...ekm3) and the second output was the change back to stake_test1ursa...kq5g's wallet.

  • The chosen DRep's payment address was found via their metadata

  • The chosen compenation amount was found via the prior CIP149 delegation transaction's metadata.

  • The DRep compensation amount was 15% of the withdrawn 700,000 ada, equalling 105,000 ada.

More example transactions

Eligibility

All applicants must successfully complete KYB (Know Your Business) verification as a condition of funding, as well as meeting the standards below tailored to the individual platforms.

  • Wallets: Must be CIP-95 compliant, listed as mainnet-compatible on gov.tools, actively maintained, and commit to open documentation.

  • Governance Tools: Publicly accessible, actively maintained, and already integrated with at least one governance process (delegation, voting, or proposal tracking). Must commit to open documentation.

  • SDKs/Libraries: Open source, actively maintained, and used by at least one mainnet application. Must provide test coverage and documentation for CIP-149 functions.

PreviousCIP-149 Optional DRep CompensationNextConsiderations

Last updated

Was this helpful?