Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: fixes 3084 #3088

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: fixes 3084 #3088

wants to merge 1 commit into from

Conversation

melissahenderson
Copy link
Contributor

@melissahenderson melissahenderson commented Nov 6, 2024

This PR covers doc issues that were discussed during a meeting with Max on Nov. 05, 2024.

@mkurapov Tagging you because of the YAML updates. Also, the OpenAPI spec for IdP is missing Continue Grant POST /interact/{id}/{nonce}. Is that intentional or should I create an issue for it?

@github-actions github-actions bot added pkg: backend Changes in the backend package. type: source Changes business logic pkg: auth Changes in the GNAP auth package. pkg: documentation Changes in the documentation package. labels Nov 6, 2024
Copy link

netlify bot commented Nov 6, 2024

Deploy Preview for brilliant-pasca-3e80ec ready!

Name Link
🔨 Latest commit a3fca70
🔍 Latest deploy log https://app.netlify.com/sites/brilliant-pasca-3e80ec/deploys/672b59de3eacbe0008424019
😎 Deploy Preview https://deploy-preview-3088--brilliant-pasca-3e80ec.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@mkurapov
Copy link
Contributor

mkurapov commented Nov 6, 2024

Also, the OpenAPI spec for IdP is missing Continue Grant POST /interact/{id}/{nonce}. Is that intentional or should I create an issue for it?

Continue Grant POST is for the Open Payments Auth API, so shouldn't be in the IdP spec

Comment on lines +271 to +282
{
"input": {
"jwk": {
"kid": "keyid-97a3a431-8ee1-48fc-ac85-70e2f5eba8e5",
"x": "ubqoInifJ5sssIPPnQR1gVPfmoZnJtPhTkyMXNoJF_8",
"alg": "EdDSA",
"kty": "OKP",
"crv": "Ed25519"
},
"walletAddressId": "695e7546-1803-4b45-96b6-6a53f4082018"
}
}
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
{
"input": {
"jwk": {
"kid": "keyid-97a3a431-8ee1-48fc-ac85-70e2f5eba8e5",
"x": "ubqoInifJ5sssIPPnQR1gVPfmoZnJtPhTkyMXNoJF_8",
"alg": "EdDSA",
"kty": "OKP",
"crv": "Ed25519"
},
"walletAddressId": "695e7546-1803-4b45-96b6-6a53f4082018"
}
}
{
"input": {
"id": "e7532552-cff9-4ffe-883e-56613d3ae611"
}
}

Comment on lines +242 to +261
mutation RevokeWalletAddressKey($input: RevokeWalletAddressKeyInput!) {
revokeWalletAddressKey(input: $input) {
code
message
success
walletAddressKey {
id
walletAddressId
revoked
jwk {
alg
crv
kid
kty
x
}
createdAt
}
}
}
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
mutation RevokeWalletAddressKey($input: RevokeWalletAddressKeyInput!) {
revokeWalletAddressKey(input: $input) {
code
message
success
walletAddressKey {
id
walletAddressId
revoked
jwk {
alg
crv
kid
kty
x
}
createdAt
}
}
}
mutation RevokeWalletAddressKey ($input: RevokeWalletAddressKeyInput!) {
revokeWalletAddressKey (input: $input) {
walletAddressKey {
id
revoked
walletAddressId
createdAt
}
}
}

@@ -11,113 +11,113 @@ webhooks:
incomingPaymentCreated:
post:
requestBody:
description: Notify account servicing entity that an incoming payment was created.
description: Notifies the account servicing entity that an incoming payment was created. This event is purely informational.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
description: Notifies the account servicing entity that an incoming payment was created. This event is purely informational.
description: Notifies the account servicing entity that an incoming payment was created.

we can actually optionally action incoming payments now via approveIncomingPayment and cancelIncomingPayment, so we can leave out the informational bit

assetCode:
type: string
description: The assetCode is a code that indicates the underlying asset. This SHOULD be an ISO4217 currency code.
description: A code that indicates the underlying asset. This SHOULD be an ISO4217 currency code.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe we can mention that it should be an ISO4217 if possible. Kind of like we have in the docs page for assets:

"The asset code, generally an ISO 4217 currency code where available."

@@ -194,11 +193,11 @@ Open Payments <LinkOut href="https://openpayments.dev/apis/wallet-address-server

<div class="overflow-table">

| Parameter | Required value | Description |
Copy link
Contributor

Choose a reason for hiding this comment

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

was this auto-formatted?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pkg: auth Changes in the GNAP auth package. pkg: backend Changes in the backend package. pkg: documentation Changes in the documentation package. type: source Changes business logic
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants