Skip to content

Commit

Permalink
[AIP] Move module for randomness generation (#184)
Browse files Browse the repository at this point in the history
* [AIP] Move module for randomness generation

* Update move-randomness.md

* Update and rename move-randomness.md to aip-41.md

---------

Co-authored-by: Frances Liu <frances.liu168@gmail.com>
  • Loading branch information
alinush and thepomeranian authored Jun 29, 2023
1 parent d08cd66 commit 9f7c8e9
Showing 1 changed file with 114 additions and 0 deletions.
114 changes: 114 additions & 0 deletions aips/aip-41.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
---
aip: 41
title: Move module for randomness generation
author: Alin Tomescu (alin@aptoslabs.com)
discussions-to (*optional): https://github.com/aptos-foundation/AIPs/issues/185
Status: Draft
last-call-end-date (*optional): <mm/dd/yyyy the last date to leave feedbacks and reviews>
type: Standard (Framework)
created: 06/27/2023
updated (*optional): <mm/dd/yyyy>
requires (*optional): <AIP number(s)>
---

# AIP-41 - Move module for randomness generation

## Summary

> Include a brief description summarizing the intended change. This should be no more than a couple of sentences. Discuss the business impact and business value this change would impact.
This AIP proposes a new Move module for smart contracts to **easily** and **safely** generate publicly-verifiable randomness, as opposed to importing it from off-chain beacons like `drand` or oracles like Chainlink.

Importantly, this generated randomness should be unbiasable and unpredictable, even by a malicious minority of the validators (as weighed by stake).

The proposed module should be part of the standard Aptos Move framework.

## Motivation

> Describe the impetus for this change. What does it accomplish? What might occur if we do not accept this proposal?
## Impact

> Which audiences are impacted by this change? What type of action does the audience need to take?
## Rationale

> Explain why you submitted this proposal specifically over alternative solutions. Why is this the best possible outcome?
## Specification

> Describe in detail precisely how this proposal should be implemented. Include proposed design principles that should be followed in implementing this feature. Make the proposal specific enough to allow others to build upon it and perhaps even derive competing implementations.
We are proposing a new Move module for generating publicly-verifiable randomness in Move smart contracts.

This module should have a very simple interface, e.g.,:

```
module aptos_std::random {
/// An object that stores randomness and can be "consumed" to generate a randomn number, a random choice,
/// a random permutation, etc.
/// This object cannot be implicitly cloned, but can be converted (or "amplified") into two or more other
/// `Randomness` objects via `randomness_amplify`.
struct Randomness { /* ... */ };
/// Generates different randomness based on the given seed and the calling contract's address.
public fun generate<T>(seed: &T): Randomness { /* ... */ }
/// Amplifies the generated randomness object into multiple objects.
public fun amplify(r: Randomness, n: u64): vector<Randomness> { /* ... */ }
/// Consumes a `Randomness` object so as to securely generate a random integer $n \in [min_incl, max_excl)$
public fun number(r: Randomness, min_incl: u64, max_excl: u64): vector<Randomness> { /* ... */ }
/// Consumes a `Randomness` object so as to securely pick a random element from a vector.
public fun pick<T>(r: Randomness, vec: &vector<T>): &T { /* ... */ }
//
// More functions can be added here to support other randomness generations operations
// (e.g., `public fun random_bytes(r: Randomness, size: u64): vector<u8>`)
//
}
```

## Reference Implementation

> This is an optional yet highly encouraged section where you may include an example of what you are seeking in this proposal. This can be in the form of code, diagrams, or even plain text. IDeally, we have a link to a living repository of code exemplifying the standard, or, for simpler cases, inline code.
## Risks and Drawbacks

> Express here the potential negative ramifications of taking on this proposal. What are the hazards?
## Future Potential

> Think through the evolution of this proposal well into the future. How do you see this playing out? What would this proposal result in in one year? In five years?
## Timeline

### Suggested implementation timeline

> Describe how long you expect the implementation effort to take, perhaps splitting it up into stages or milestones.
### Suggested developer platform support timeline

> Describe the plan to have SDK, API, CLI, Indexer support for this feature is applicable.
### Suggested deployment timeline

> When should community expect to see this deployed on devnet?
>
> On testnet?
>
> On mainnet?
## Security Considerations

> Has this change being audited by any auditing firm?
> Any potential scams? What are the mitigation strategies?
> Any security implications/considerations?
> Any security design docs or auditing materials that can be shared?
## Testing (optional)

> What is the testing plan? How is this being tested?

0 comments on commit 9f7c8e9

Please sign in to comment.