diff --git a/packages/std/src/base64/base64.ts b/packages/std/src/base64/base64.ts
index b42bde7..0173a9b 100644
--- a/packages/std/src/base64/base64.ts
+++ b/packages/std/src/base64/base64.ts
@@ -1,6 +1,10 @@
 import { base64abc } from './_base64abc'
 import { validateBinaryLike } from './_validate-binary-like'
 
+/**
+ * @deprecated use `Uint8Array.toBase64` instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toBase64}
+ */
 export const encodeBase64 = (data: ArrayBuffer | string | Uint8Array): string => {
   const uint8 = validateBinaryLike(data)
   let result = ''
@@ -35,6 +39,10 @@ export const encodeBase64 = (data: ArrayBuffer | string | Uint8Array): string =>
   return result
 }
 
+/**
+ * @deprecated use `Uint8Array.fromBase64` instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/fromBase64}
+ */
 export const decodeBase64 = (b64: string): Uint8Array => {
   // eslint-disable-next-line @masknet/no-builtin-base64
   const binString = atob(b64)
diff --git a/packages/std/src/base64/base64url.ts b/packages/std/src/base64/base64url.ts
index bb5386a..8508a20 100644
--- a/packages/std/src/base64/base64url.ts
+++ b/packages/std/src/base64/base64url.ts
@@ -1,3 +1,4 @@
+/* eslint-disable sonarjs/deprecation */
 import { decodeBase64, encodeBase64 } from './base64'
 
 const addPaddingToBase64url = (b64url: string): string => {