Skip to content
This repository was archived by the owner on Aug 10, 2026. It is now read-only.

[EDX-156] Replace the undefined Params type in IDL - #1464

Merged
tbedford merged 2 commits into
mainfrom
EDX-156-clarify-getDefaultParams-arguments-in-IDL
Jun 20, 2022
Merged

[EDX-156] Replace the undefined Params type in IDL#1464
tbedford merged 2 commits into
mainfrom
EDX-156-clarify-getDefaultParams-arguments-in-IDL

Conversation

@lawrence-forooghian

@lawrence-forooghianlawrence-forooghian commented Jun 15, 2022

Copy link
Copy Markdown
Contributor

Description

This addresses the Params type that’s mentioned in the IDL as the value for ChannelOptions.cipher or Crypto.getDefaultParams()’s argument. This type is not actually defined anywhere.

I’ve taken the opportunity to turn this into a concrete CipherParamOptions type in the spec, because the current language of “any subset of @CipherParams@ fields…” is not correct since the types of the key value do not agree — in CipherParams it can only be a binary, but in CipherParamsOptions it can be a binary or a string.

I’ve taken the type name from ably/ably-js@48a66d6.

@kennethkalmer
kennethkalmer temporarily deployed to ably-docs-edx-156-clari-0x0sm2 June 15, 2022 17:06 Inactive
@lawrence-forooghian
lawrence-forooghianforce-pushed the EDX-156-clarify-getDefaultParams-arguments-in-IDL branch from 786deee to 4d88decCompareJune 15, 2022 17:08
@kennethkalmer
kennethkalmer temporarily deployed to ably-docs-edx-156-clari-0x0sm2 June 15, 2022 17:08 Inactive
@lawrence-forooghian
lawrence-forooghianforce-pushed the EDX-156-clarify-getDefaultParams-arguments-in-IDL branch from 4d88dec to 2f17ea9CompareJune 15, 2022 17:10
@kennethkalmer
kennethkalmer temporarily deployed to ably-docs-edx-156-clari-0x0sm2 June 15, 2022 17:10 Inactive
@lawrence-forooghian
lawrence-forooghian marked this pull request as ready for review June 15, 2022 17:12

@maratalmaratal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@QuintinWillisonQuintinWillison left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be nice to see the CO2 sub-points have some explanation and probably example values (e.g. AES, CBC and 128-bit; being typical).

Comment threadcontent/client-lib-development-guide/features.textile Outdated
I’ve taken the opportunity to turn this into a concrete
CipherParamOptions type in the spec, because the current language of
“any subset of @CipherParams@ fields…” is not correct since the types of
the `key` value do not agree — in CipherParams it can only be a binary,
but in CipherParamsOptions it can be a binary or a string.
I’ve taken the type name from ably-js@48a66d6. The descriptions of the
properties come from the corresponding descriptions of CipherParams in
TZ2.
@lawrence-forooghian
lawrence-forooghianforce-pushed the EDX-156-clarify-getDefaultParams-arguments-in-IDL branch from 2f17ea9 to ae3a2f0CompareJune 19, 2022 18:48
@kennethkalmer
kennethkalmer temporarily deployed to ably-docs-edx-156-clari-0x0sm2 June 19, 2022 18:49 Inactive
@lawrence-forooghian

Copy link
Copy Markdown
ContributorAuthor

It would be nice to see the CO2 sub-points have some explanation and probably example values (e.g. AES, CBC and 128-bit; being typical).

Done. I’ve adapted the descriptions from the existing ones for CipherParams in TZ2.

@tbedford
tbedford merged commit 968819c into mainJun 20, 2022
@tbedford
tbedford deleted the EDX-156-clarify-getDefaultParams-arguments-in-IDL branch June 20, 2022 13:08
Sign up for freeto subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@lawrence-forooghian@Peter-Maguire@QuintinWillison@maratal@kennethkalmer@tbedford