Skip to content

Commit

Permalink
Functions: Add UI request timeout instructions (#2041)
Browse files Browse the repository at this point in the history
* Add request timeout instructions

* Fix links and formatting

* Clarification

* Update release-notes.mdx

* Update release-notes.mdx

more direct

* Update subscriptions.mdx

---------

Co-authored-by: Amine E. <aelmanaa@users.noreply.github.com>
  • Loading branch information
thedriftofwords and aelmanaa authored Aug 21, 2024
1 parent d066528 commit 57ab2cf
Show file tree
Hide file tree
Showing 8 changed files with 54 additions and 0 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions src/content/chainlink-functions/resources/release-notes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ title: "Chainlink Functions Release Notes"

import { Aside } from "@components"

## Timing out requests manually - 2024-08-21

The [Chainlink Functions Subscription Manager](https://functions.chain.link/) now supports [timing out requests manually](/chainlink-functions/resources/subscriptions#time-out-pending-requests-manually). You can time out requests that are pending for longer than five minutes to unlock your subscription funds.

## USD-denominated premium fees on all networks - 2024-07-31

Chainlink Functions now uses USD-denominated fixed premium fees on all [supported networks](/chainlink-functions/supported-networks). This means that the premium fees are set in USD, but no USD is ever used. The LINK equivalent of the fee is calculated at request time, and then deducted from your subscription in LINK at response time. See the [example cost calculation](/chainlink-functions/resources/billing#cost-calculation-example) for more information.
Expand Down
50 changes: 50 additions & 0 deletions src/content/chainlink-functions/resources/subscriptions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -206,3 +206,53 @@ You use a Chainlink Functions subscription to pay for, manage, and track Functio
src="/images/chainlink-functions/tutorials/subscription/your-subscription-cancelled.jpg"
alt="Chainlink Functions subscription canceled"
/>

## Time out pending requests manually

The Subscription Manager provides the option to time out requests manually. You can time out requests that have been pending for longer than five minutes to unlock your subscription funds.

1. Open your subscription details and scroll to the **Pending** section. If a request has been pending longer than five minutes, its status displays as _Time out required_. Click the link within the red banner that says **Time out request**:

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/1-request-eligible-for-timeout.png"
alt="Pending Functions request eligible for timeout"
/>

If you have multiple requests that are eligible for timeout, the **Time out request** link in the red banner times out all the requests at once.

Alternatively, you can time out an individual request. Open the **Actions** menu for that request, and click **Time out request**:

{" "}

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/individual-request-timeout.png"
alt="Individual request timeout"
/>

1. A MetaMask popup appears, and you are asked to confirm the transaction:

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/2-approve-timeout-transaction.png"
alt="Prompt to approve timeout transaction"
/>

1. After you confirm the transaction, a confirmation screen appears:

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/3-timeout-successful-confirmation.png"
alt="Timeout transaction confirmation"
/>

1. The subscription details page displays another confirmation in the upper right corner showing that the request has been timed out successfully:

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/4-subscription-page-updates.png"
alt="Request timed out dialog"
/>

1. The timed out request appears in the **Failed fulfillments** tab of the **History** section:

<ClickToZoom
src="/images/chainlink-functions/tutorials/request-timeout/5-failed-fulfillments.png"
alt="Chainlink Functions subscription canceled"
/>

0 comments on commit 57ab2cf

Please sign in to comment.