CIP30: experimental api section

[SebastienGllmt]

Problem

1. Many wallets have started defining their own functions that aren't part of CIP30. It makes it hard for dApp devs to know which functions are standardized (supported by all wallets) and which are wallet-specific
2. We currently have no clear process for updating the CIP30 api version

Adding an "Experimental API" section to CIP30 aims to solve these issues.

Experimental API

Functions in this section must be under the experimental namespace (ex: api.experimental.myFunctionality).

The benefits of this are:

1. Wallets can add non-standardized features while still following the CIP30 structure
2. dApp developers can use these functions explicitly knowing they are experimental (not stable or standardized)
3. New features can be added to CIP30 as experimental features and only moved to non-experimental once multiple wallets implement it
4. It provides a clear path to updating the CIP version number (when functions move from experimental -> stable)

[alessandrokonrad]

That is a great idea. Then I can finally move Nami to CIP-0030, while still supporting some of the custom endpoints and event functions.

[MarcelKlammer]

Just to clarify, that would be?:

const fullApi = await window.cardano.walletName.enable() // walletName: eg. nami or ccvault

await fullApi.experimental.functionName()

[SebastienGllmt]

@MarcelKlammer yes, that's correct

[MarcelKlammer]

Today I had a feature request of a nft marketplace for an appVersion property, which can be read ahead of calling enable().

So I put it here:

window.cardano.ccvault.experimental.appVersion = { major: 1, minor 3, patch: 9 }

So we could also add such an object in the wallet namespace.

[SebastienGllmt]

Just an FYI, Nami, ccvault and Flint now all use this experimental field so I think probably this should be merged

In general probably we need a modification to CIP30 to define when we can merge these though

[rooooooooob]

LGTM

[rphair]

Although I don't understand every detail of this spec, the additions look understandable, useful & well precedented to me.

[vsubhuman]

Note, Yoroi is updating to utilise this as well