diff --git a/.changeset/blue-plants-mate.md b/.changeset/blue-plants-mate.md new file mode 100644 index 00000000000..156a1e5e8e2 --- /dev/null +++ b/.changeset/blue-plants-mate.md @@ -0,0 +1,5 @@ +--- +"@fuel-ts/account": patch +--- + +feat: add `getMessageByNonce` to `Provider` diff --git a/apps/docs-snippets/src/guide/provider/querying-the-chain.test.ts b/apps/docs-snippets/src/guide/provider/querying-the-chain.test.ts index d841dae87f2..dad14a9f7cc 100644 --- a/apps/docs-snippets/src/guide/provider/querying-the-chain.test.ts +++ b/apps/docs-snippets/src/guide/provider/querying-the-chain.test.ts @@ -111,4 +111,18 @@ describe('querying the chain', () => { // #endregion Provider-get-blocks expect(blocks.length).toBe(10); }); + + it('can getMessageByNonce', async () => { + // #region getMessageByNonce + // #import { FUEL_NETWORK_URL, Provider }; + + const provider = await Provider.create(FUEL_NETWORK_URL); + + const nonce = '0x381de90750098776c71544527fd253412908dec3d07ce9a7367bd1ba975908a0'; + const message = await provider.getMessageByNonce(nonce); + + expect(message).toBeDefined(); + expect(message?.nonce).toEqual(nonce); + // #endregion getMessageByNonce + }); }); diff --git a/apps/docs/src/guide/provider/querying-the-chain.md b/apps/docs/src/guide/provider/querying-the-chain.md index ef0420292c9..a9634929318 100644 --- a/apps/docs/src/guide/provider/querying-the-chain.md +++ b/apps/docs/src/guide/provider/querying-the-chain.md @@ -39,6 +39,12 @@ This method returns all the blocks from the blockchain that match the given quer <<< @/../../docs-snippets/src/guide/provider/querying-the-chain.test.ts#Provider-get-blocks{ts:line-numbers} +## Get a message by its nonce + +You can use the `getMessageByNonce` method to retrieve a message by its nonce. + +<<< @/../../docs-snippets/src/guide/provider/querying-the-chain.test.ts#getMessageByNonce{ts:line-numbers} +