Automated scrape: 2026-05-22 01:21:29

Author: github-actions[bot]

merged_docs/all_merged.md

@@ -5636,13 +5636,14 @@ access(all) resource BankAccount {
 If there are any functions that modify privileged state that also need to be callable from external code, use [entitlements] for the access modifiers for those functions:
 
 ```cadence
-/// Simplified Vault implementation
+/// Declare Entitlements at the contract level — entitlements are
+/// namespaced to their contract and referenced by access modifiers
+/// on the contract's resources, structs, and functions.
+access(all) entitlement Owner
+
 /// Simplified Bank Account implementation
 access(all) resource BankAccount {
 
-    /// Declare Entitlements for state-modifying functions
-    access(all) entitlement Owner
-
     /// Fields should default to access(self) just to be safe
     access(self) var balance: UFix64
 
@@ -5694,7 +5695,7 @@ When issuing a capability, a capability of the same type might already be presen
     var flowTokenVaultCap: Capability<auth(FungibleToken.Withdraw) &FlowToken.Vault>? = nil
 
     // Get all the capabilities that have already been issued for the desired storage path
-    let flowTokenVaultCaps = account.capabilities.storage.getControllers(forPath: /storage/flowTokenVault)
+    let flowTokenVaultCaps = signer.capabilities.storage.getControllers(forPath: /storage/flowTokenVault)
 
     // Iterate through them to see if there is already one of the needed type
     for cap in flowTokenVaultCaps {
@@ -5708,7 +5709,7 @@ When issuing a capability, a capability of the same type might already be presen
     // issue a new one
     if flowTokenVaultCap == nil {
         // issue a new entitled capability to the flow token vault
-        flowTokenVaultCap = account.capabilities.storage.issue<auth(FungibleToken.Withdraw) &FlowToken.Vault>(/storage/flowTokenVault)
+        flowTokenVaultCap = signer.capabilities.storage.issue<auth(FungibleToken.Withdraw) &FlowToken.Vault>(/storage/flowTokenVault)
     }
 ```
 
@@ -5718,7 +5719,7 @@ When publishing a capability, a published capability might already be present. I
 
 ```cadence
 // Check if the published capability already exists
-if account.capabilities.borrow<&FlowToken.Vault>(/public/flowTokenReceiver) == nil {
+if signer.capabilities.borrow<&FlowToken.Vault>(/public/flowTokenReceiver) == nil {
     // since it doesn't exist yet, we should publish a new one that we created earlier
     signer.capabilities.publish(
         receiverCapability,
@@ -5786,7 +5787,7 @@ If given a less-specific type, cast to the more specific type that is expected.
 
 <!-- Relative links. Will not render on the page -->
 
-[Cadence Anti-Patterns]: ./design-patterns.md
+[Cadence Anti-Patterns]: ./anti-patterns.md
 [References]: ./language/references.mdx
 [account storage]: ./language/accounts/storage.mdx
 [borrow]: ./language/capabilities.md#capabilities-in-accounts
@@ -9220,7 +9221,7 @@ Adding `self.account.save` or `self.account.publish` to `mintNFT` allows anyone
 
 Passing a [fully authorized account reference] as a function parameter is a dangerous anti-pattern.
 
-::::
+:::
 
 ### Deploying and testing
 
@@ -12071,7 +12072,9 @@ fun transferNFT(id: UInt64, owner: auth(Storage) &Account) {
     // Sneakily borrow a reference to the user's Flow Token Vault
     // and withdraw a bit of FLOW
     // BAD
-    let vaultRef = owner.borrow<&FlowToken.Vault>(/storage/flowTokenVault)!
+    let vaultRef = owner.storage.borrow<auth(FungibleToken.Withdraw) &FlowToken.Vault>(
+        from: /storage/flowTokenVault
+    )!
     let stolenTokens <- vaultRef.withdraw(amount: 0.1)
 
     // deposit the stolen funds in the contract owners vault
@@ -17904,7 +17907,7 @@ contract NamedFields {
     init() {
         // assign and access the field here and in transactions
         self.testStoragePath = /storage/testStorage
-        self.account.storage.save(<-create Test(), to: self.TestStoragePath)
+        self.account.storage.save(<-create Test(), to: self.testStoragePath)
     }
 }
 
@@ -18214,15 +18217,15 @@ transaction {
     prepare(acct: auth(LoadValue, SaveValue) &Account) {
 
         // Removes the vault from storage, a costly operation
-        let vault <- acct.storage.load<@ExampleToken.Vault>(from: /storage/exampleToken)
+        let vault <- acct.storage.load<@ExampleToken.Vault>(from: /storage/exampleToken)!
 
         // Withdraws tokens
-        let burnVault <- vault.withdraw(amount: 10)
+        let burnVault <- vault.withdraw(amount: 10.0)
 
         destroy burnVault
 
         // Saves the used vault back to storage, another costly operation
-        acct.storage.save(to: /storage/exampleToken)
+        acct.storage.save(<-vault, to: /storage/exampleToken)
 
     }
 }
@@ -18234,9 +18237,13 @@ transaction {
     prepare(acct: auth(BorrowValue) &Account) {
 
         // Borrows a reference to the stored vault, much less costly operation
-        let vault <- acct.storage.borrow<&ExampleToken.Vault>(from: /storage/exampleToken)
+        // Borrow returns an optional reference; force-unwrap (or null-check) before use.
+        // The reference must be authorized to call entitled methods like `withdraw`.
+        let vaultRef = acct.storage.borrow<auth(FungibleToken.Withdraw) &ExampleToken.Vault>(
+            from: /storage/exampleToken
+        )!
 
-        let burnVault <- vault.withdraw(amount: 10)
+        let burnVault <- vaultRef.withdraw(amount: 10.0)
 
         destroy burnVault
 
@@ -18358,25 +18365,25 @@ transaction {
         var capability: Capability<&ExampleToken.Vault>? = nil
 
         // get the capability to the vault at the given storage path if it exists
-        let vaultCaps = account.capabilities.storage.getControllers(forPath: /storage/exampleTokenVault)
+        let vaultCaps = signer.capabilities.storage.getControllers(forPath: /storage/exampleTokenVault)
         for cap in vaultCaps {
-            if let cap = cap as? Capability<&ExampleToken.Vault> {
+            if let cap = cap.capability as? Capability<&ExampleToken.Vault> {
                 capability = cap
                 break
             }
         }
 
         if capability == nil {
             // issue a new capability to the vault since it wasn't found
-            capability = account.capabilities.storage.issue<&ExampleToken.Vault>(/storage/exampleTokenVault)
+            capability = signer.capabilities.storage.issue<&ExampleToken.Vault>(/storage/exampleTokenVault)
         }
 
         let publicPath = /public/exampleTokenReceiver
 
-        if signer.capabilities.exits(publicPath) {
+        if signer.capabilities.exists(publicPath) {
             signer.capabilities.unpublish(publicPath)
         }
-        signer.capabilities.publish(capability, at: publicPath)
+        signer.capabilities.publish(capability!, at: publicPath)
     }
 }
 ```

merged_docs/cadence_docs_merged.md

@@ -457259,13 +457259,14 @@ access(all) resource BankAccount {
 If there are any functions that modify privileged state that also need to be callable from external code, use [entitlements] for the access modifiers for those functions:
 
 ```cadence
-/// Simplified Vault implementation
+/// Declare Entitlements at the contract level — entitlements are
+/// namespaced to their contract and referenced by access modifiers
+/// on the contract's resources, structs, and functions.
+access(all) entitlement Owner
+
 /// Simplified Bank Account implementation
 access(all) resource BankAccount {
 
-    /// Declare Entitlements for state-modifying functions
-    access(all) entitlement Owner
-
     /// Fields should default to access(self) just to be safe
     access(self) var balance: UFix64
 
@@ -457317,7 +457318,7 @@ When issuing a capability, a capability of the same type might already be presen
     var flowTokenVaultCap: Capability<auth(FungibleToken.Withdraw) &FlowToken.Vault>? = nil
 
     // Get all the capabilities that have already been issued for the desired storage path
-    let flowTokenVaultCaps = account.capabilities.storage.getControllers(forPath: /storage/flowTokenVault)
+    let flowTokenVaultCaps = signer.capabilities.storage.getControllers(forPath: /storage/flowTokenVault)
 
     // Iterate through them to see if there is already one of the needed type
     for cap in flowTokenVaultCaps {
@@ -457331,7 +457332,7 @@ When issuing a capability, a capability of the same type might already be presen
     // issue a new one
     if flowTokenVaultCap == nil {
         // issue a new entitled capability to the flow token vault
-        flowTokenVaultCap = account.capabilities.storage.issue<auth(FungibleToken.Withdraw) &FlowToken.Vault>(/storage/flowTokenVault)
+        flowTokenVaultCap = signer.capabilities.storage.issue<auth(FungibleToken.Withdraw) &FlowToken.Vault>(/storage/flowTokenVault)
     }
 ```
 
@@ -457341,7 +457342,7 @@ When publishing a capability, a published capability might already be present. I
 
 ```cadence
 // Check if the published capability already exists
-if account.capabilities.borrow<&FlowToken.Vault>(/public/flowTokenReceiver) == nil {
+if signer.capabilities.borrow<&FlowToken.Vault>(/public/flowTokenReceiver) == nil {
     // since it doesn't exist yet, we should publish a new one that we created earlier
     signer.capabilities.publish(
         receiverCapability,
@@ -457409,7 +457410,7 @@ If given a less-specific type, cast to the more specific type that is expected.
 
 <!-- Relative links. Will not render on the page -->
 
-[Cadence Anti-Patterns]: ./design-patterns.md
+[Cadence Anti-Patterns]: ./anti-patterns.md
 [References]: ./language/references.mdx
 [account storage]: ./language/accounts/storage.mdx
 [borrow]: ./language/capabilities.md#capabilities-in-accounts
@@ -460843,7 +460844,7 @@ Adding `self.account.save` or `self.account.publish` to `mintNFT` allows anyone
 
 Passing a [fully authorized account reference] as a function parameter is a dangerous anti-pattern.
 
-::::
+:::
 
 ### Deploying and testing
 
@@ -463694,7 +463695,9 @@ fun transferNFT(id: UInt64, owner: auth(Storage) &Account) {
     // Sneakily borrow a reference to the user's Flow Token Vault
     // and withdraw a bit of FLOW
     // BAD
-    let vaultRef = owner.borrow<&FlowToken.Vault>(/storage/flowTokenVault)!
+    let vaultRef = owner.storage.borrow<auth(FungibleToken.Withdraw) &FlowToken.Vault>(
+        from: /storage/flowTokenVault
+    )!
     let stolenTokens <- vaultRef.withdraw(amount: 0.1)
 
     // deposit the stolen funds in the contract owners vault
@@ -469527,7 +469530,7 @@ contract NamedFields {
     init() {
         // assign and access the field here and in transactions
         self.testStoragePath = /storage/testStorage
-        self.account.storage.save(<-create Test(), to: self.TestStoragePath)
+        self.account.storage.save(<-create Test(), to: self.testStoragePath)
     }
 }
 
@@ -469837,15 +469840,15 @@ transaction {
     prepare(acct: auth(LoadValue, SaveValue) &Account) {
 
         // Removes the vault from storage, a costly operation
-        let vault <- acct.storage.load<@ExampleToken.Vault>(from: /storage/exampleToken)
+        let vault <- acct.storage.load<@ExampleToken.Vault>(from: /storage/exampleToken)!
 
         // Withdraws tokens
-        let burnVault <- vault.withdraw(amount: 10)
+        let burnVault <- vault.withdraw(amount: 10.0)
 
         destroy burnVault
 
         // Saves the used vault back to storage, another costly operation
-        acct.storage.save(to: /storage/exampleToken)
+        acct.storage.save(<-vault, to: /storage/exampleToken)
 
     }
 }
@@ -469857,9 +469860,13 @@ transaction {
     prepare(acct: auth(BorrowValue) &Account) {
 
         // Borrows a reference to the stored vault, much less costly operation
-        let vault <- acct.storage.borrow<&ExampleToken.Vault>(from: /storage/exampleToken)
+        // Borrow returns an optional reference; force-unwrap (or null-check) before use.
+        // The reference must be authorized to call entitled methods like `withdraw`.
+        let vaultRef = acct.storage.borrow<auth(FungibleToken.Withdraw) &ExampleToken.Vault>(
+            from: /storage/exampleToken
+        )!
 
-        let burnVault <- vault.withdraw(amount: 10)
+        let burnVault <- vaultRef.withdraw(amount: 10.0)
 
         destroy burnVault
 
@@ -469981,25 +469988,25 @@ transaction {
         var capability: Capability<&ExampleToken.Vault>? = nil
 
         // get the capability to the vault at the given storage path if it exists
-        let vaultCaps = account.capabilities.storage.getControllers(forPath: /storage/exampleTokenVault)
+        let vaultCaps = signer.capabilities.storage.getControllers(forPath: /storage/exampleTokenVault)
         for cap in vaultCaps {
-            if let cap = cap as? Capability<&ExampleToken.Vault> {
+            if let cap = cap.capability as? Capability<&ExampleToken.Vault> {
                 capability = cap
                 break
             }
         }
 
         if capability == nil {
             // issue a new capability to the vault since it wasn't found
-            capability = account.capabilities.storage.issue<&ExampleToken.Vault>(/storage/exampleTokenVault)
+            capability = signer.capabilities.storage.issue<&ExampleToken.Vault>(/storage/exampleTokenVault)
         }
 
         let publicPath = /public/exampleTokenReceiver
 
-        if signer.capabilities.exits(publicPath) {
+        if signer.capabilities.exists(publicPath) {
             signer.capabilities.unpublish(publicPath)
         }
-        signer.capabilities.publish(capability, at: publicPath)
+        signer.capabilities.publish(capability!, at: publicPath)
     }
 }
 ```