/construction/derive staking support

[AlanVerbner]

Description

• There are several addresses types in Cardano (for further info see the Ledger Spec - Section 4). Two of them are going to be supported by Cardano Rosetta:
  • Enterprise addresses: do not hold any delegation rights and will be created when no stake key is sent to the API
  • Base addresses: associated to a payment and a staking credential.

Enterprise addresses are already supported and the goal for this task is to let users to be able to create Base addresses as well, in order to do so, /construction/derive needs to be updated. A non exhaustive list of sub tasks can be defined as:

• Update openApi.json to let ConstructionDeriveRequest to accept staking_credential: #/components/schemas/PublicKey as an optional parameter alongside with a new type AddressType = {Enterprise, Base, Reward} which is optional as well.
• Regenerate the API ts types to include the new addition, yarn generate-rosetta-types
• Modify construction-controller.ts to process the before mentioned parameter and forward it to cardano-service.ts
• Add the proper logic in cardano-service.ts to generate:
  • A BaseAddress if both credentials are received and type is Base
  • A RewardAddress if type is Reward (only the required public key is used as the staking key)
  • An Enterprise address if a single key is received (i.e. no staking_credential) and type is Enterprise or empty
  • Error otherwise
• Update the test to properly validate the new functionality. The tests should, at least, return ok results for the given test vectors.

Test Vector

1. Base Address

cat addr.prv \
>   | ./cardano-address key public \
>   | ./cardano-address address payment  --network-tag 1 \
>   | ./cardano-address address delegation $(cat stake.prv | ./cardano-address key public)
addr1q9dhy809valxaer3nlvg2h5nudd62pxp6lu0cs36zczhfr98y6pah6lvppk8xft57nef6yexqh6rr204yemcmm3emhzsgg4fg0

stake.prv.txt
addr.prv.txt

Note: Uploaded as txt due to GH restrictions

public_key.hex_bytes: 159abeeecdf167ccc0ea60b30f9522154a0d74161aeb159fb43b6b0695f057b3
staking_key.hex_bytes: 964774728c8306a42252adbfb07ccd6ef42399f427ade25a5933ce190c5a8760

2. Reward address

https://cardanoscan.io/address/015b721de5677e6ee4719fd8855e93e35ba504c1d7f8fc423a1605748ca72683dbebec086c732574f4f29d132605f431a9f526778dee39ddc5

keyhash: a72683dbebec086c732574f4f29d132605f431a9f526778dee39ddc5
BECH32 stake1uxnjdq7ma0kqsmrny460fu5azvnqtap3486jvaudacuam3g3yc4nu

staking_key.hex_bytes: 964774728c8306a42252adbfb07ccd6ef42399f427ade25a5933ce190c5a8760

References

• https://www.rosetta-api.org/docs/models/ConstructionDeriveRequest.html